第三方平台
第三方平台概述
创建第三方平台
常见问题排查指南

申请「抖音直播组件」能力

为授权小程序申请「抖音直播组件」能力

请求地址

POST   https://open.microapp.bytedance.com/openapi/v1/microapp/operation/live_application

 

Query 参数

参数名参数类型是否必须备注
component_appidstring第三方平台的 appid
authorizer_access_tokenstring授权小程序的接口调用令牌

Body 参数(json)

参数名参数类型是否必须备注
introstring活动介绍及预估收益
字数限制:300
firstLiveTimeint预计首次开播时间
时间戳
liveFrequencyint预估每周开播场次
2:代表少于 3 场,3:代表 5 场以内,4:代表 5-10 场
hasAdBudgetint是否有广告预算
0:否,1:是
adBudgetAmountint投放预算
hasAdBudget 为 1 时才可以传值,且不能为 0
限定整数,单位:元
adPersonNamestring销售对接人姓名
字数限制:10
hasAdBudget 为 1 时才可以传值。此项暂无可不填,详情咨询巨量引擎

Body 参数示例

{
  "intro": "xxx",
  "firstLiveTime": 1535551395,
  "liveFrequency": 2,
  "hasAdBudget": 1,
  "adBudgetAmount": 1000,
  "adPersonName": "xxx"
}

 

返回值

参数名参数类型备注
errnoint错误码
messagestring错误信息

返回值示例

{
  "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"
  }
}

消息体字段含义如下:

参数名参数类型备注
AppIdstring授权小程序的 appid
TpAppIdstring第三方平台的 appid
EventTimestring推送事件时间
Eventstring推送事件类型
ApplyLiveCapabilityResultsobject「抖音直播组件」能力申请的审核结果
reasonstring如果被拒,被拒原因
statusint0:代表不通过,1:代表通过,2:代表能力关闭
点击纠错
评价此篇文档