申请「抖音直播组件」能力
为授权小程序申请「抖音直播组件」能力
请求地址
POST https://open.microapp.bytedance.com/openapi/v1/microapp/operation/live_application
Query 参数
参数名 | 参数类型 | 是否必须 | 备注 |
---|---|---|---|
component_appid | string | 是 | 第三方平台的 appid |
authorizer_access_token | string | 是 | 授权小程序的接口调用令牌 |
Body 参数(json)
参数名 | 参数类型 | 是否必须 | 备注 |
---|---|---|---|
intro | string | 是 | 活动介绍及预估收益 字数限制:300 |
firstLiveTime | int | 是 | 预计首次开播时间 时间戳 |
liveFrequency | int | 是 | 预估每周开播场次 2:代表少于 3 场,3:代表 5 场以内,4:代表 5-10 场 |
hasAdBudget | int | 是 | 是否有广告预算 0:否,1:是 |
adBudgetAmount | int | 否 | 投放预算 hasAdBudget 为 1 时才可以传值,且不能为 0 限定整数,单位:元 |
adPersonName | string | 否 | 销售对接人姓名 字数限制:10 hasAdBudget 为 1 时才可以传值。此项暂无可不填,详情咨询巨量引擎 |
Body 参数示例
{
"intro": "xxx",
"firstLiveTime": 1535551395,
"liveFrequency": 2,
"hasAdBudget": 1,
"adBudgetAmount": 1000,
"adPersonName": "xxx"
}
返回值
参数名 | 参数类型 | 备注 |
---|---|---|
errno | int | 错误码 |
message | string | 错误信息 |
返回值示例
{
"errno": 0,
"message": "success"
}
错误码
参数名 | 参数类型 |
---|---|
30001 | 未找到对应能力类型 |
30004 | 请勿重复申请 |
30005 | 不满足申请条件 |
30006 | 申请信息格式错误 |
30007 | 请填写完整申请信息 |
30008 | 未找到小程序 |
30009 | 请正确填写申请信息-场景描述 |
「抖音直播组件」能力申请审核结果通知
「抖音直播组件」能力申请审核结果出来之后,会自动触发消息发送,然后第三方应用会收到由第三方服务器推送的相应授权小程序的「抖音直播组件」能力申请的审核结果。
POST 数据示例:
{
"Nonce": "4464221",
"TimeStamp": "1535551395",
"Encrypt": "Encrypt Message xxxxxxxx",
"MsgSignature": "ba394c04acece6c2c0edee058c5dddf82474b8ee"
}
其中 Encrypt 参数需要解密,解密详情见第三方平台消息加密解密部分:
{
"AppId": 授权小程序的appid,
"TpAppId": 第三方平台appid,
"EventTime": "2019-01-14 12:45:10",
"Event": "APPLY_LIVE_CAPABILITY",
"ApplyLiveCapabilityResults": {
"status": 0,
"reason": "xxx"
}
}
消息体字段含义如下:
参数名 | 参数类型 | 备注 |
---|---|---|
AppId | string | 授权小程序的 appid |
TpAppId | string | 第三方平台的 appid |
EventTime | string | 推送事件时间 |
Event | string | 推送事件类型 |
ApplyLiveCapabilityResults | object | 「抖音直播组件」能力申请的审核结果 |
reason | string | 如果被拒,被拒原因 |
status | int | 0:代表不通过,1:代表通过,2:代表能力关闭 |
点击纠错
评价此篇文档