直播挂载能力管理

更新时间：2023-02-15 10:49:46

直播挂载能力代管理为第三方应用提供客户小程序发快手能力的代开通、状态代查询以及达人名单获取三个接口。直播挂载能力简介及相关说明可以参考文档 (opens new window)。

直播挂载能力开通

该接口用于第三方应用为授权小程序开通“直播挂载”能力。

接口说明

请求头	说明
url	https://open.kuaishou.com/openapi/mp/auth/liveStudio/audit/submit
Method	POST

请求参数

查询参数

参数	是否必须	类型	备注
component_app_id	是	string	第三方应用appId
authorizer_access_token	是	string	授权小程序接口调用凭据

请求体

参数	是否必须	类型	备注
sceneDesc	是	string	申请原因
sceneSample	是	Binary	落地页图片

示例

{
  "sceneDesc": "xxx",
  "sceneSample": "txxx"
}

响应

参数名	类型	描述
result	number	状态码 1-成功 非1-错误码
error_msg	string	错误提示信息，常见错误处理可参考附录常见问题章节

示例

{
    "result":1,
  "error_msg":"sucess"
}

错误码

错误码	说明
500000	提审失败
403017	小程序还未上线

直播挂载状态查询

该接口用于第三方应用为授权小程序查询“直播挂载”能力的开通状态。

接口说明

请求头	说明
url	https://open.kuaishou.com/openapi/mp/auth/liveStudio/info
Method	GET

请求参数

查询参数

参数	是否必须	类型	备注
component_app_id	是	string	第三方应用appId
authorizer_access_token	是	string	授权小程序接口调用凭据

请求体

参数名	类型	描述
result	number	状态码 1-成功 非1-错误码
error_msg	string	错误提示信息，常见错误处理可参考附录常见问题章节
status	AuditStatus	审核状态 0-未提审 1-审核中 2-通过 3-未通过
reason	string	拒审原因
enableLiveStudio	boolean	是否开通直播挂载
isTestingMp	boolean	是否为娱乐测试类小程序，该小程序暂不支持开通直播挂载能力

示例

{
    "result":1,
  "error_msg":"sucess",
  "status": 2,
  "reason": ""
}

错误码

错误码	说明
403015	小程序本身还未提审
403101	小程序本身还未过审
403014	审核中、审核已通过

直播挂载成员查询

该接口用于第三方应用为授权小程序查询“短视频挂载”能力的可挂载成员，短视频挂载能力简介及相关说明可以参考文档

接口说明

请求头	说明
url	https://open.kuaishou.com/openapi/mp/auth/liveStudio/members
Method	GET

请求参数

查询参数

参数	是否必须	类型	备注
component_app_id	是	string	第三方应用appId
authorizer_access_token	是	string	授权小程序接口调用凭据
pageNum	是	string	返回达人信息的页码数，例：如果设置2，则返回第2页的达人记录
pageSize	是	string	返回达人信息的分页数，例：如果设置100，则每页返回100条达人记录

请求体

参数名	类型	描述
result	number	状态码 1-成功 非1-错误码
error_msg	string	错误提示信息，常见错误处理可参考附录常见问题章节
plcUser	{userId: number;bindTime: number;}[]	成员ID和绑定时间
paged	{ total: number }	总数

示例

{
    "result":1,
  "error_msg":"sucess",
  "plcUser": [{"userId": 123, bindTime: 77000772}],
  "paged": { "total": 1}
}

错误码

错误码	说明
403015	小程序本身还未提审
403101	小程序本身还未过审