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

我的收藏

接口介绍

该接口用于第三方小程序应用为授权小程序申请「抖音直播组件」能力。

请求

基本信息

基本
`HTTP URL`	`https://open.microapp.bytedance.com/openapi/v1/microapp/operation/live_application`
`HTTP Method`	`POST`
`权限要求`	授权小程序授予运营管理权限

查询参数

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

请求体（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 时才可以传值。此项暂无可不填，详情咨询巨量引擎

请求体示例

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

响应

响应体

参数名	参数类型	备注
`errno`	`int`	错误码
`message`	`string`	错误信息

响应体示例

{
  "errno": 0,
  "message": "success"
}

错误码

错误码	message
30001	未找到对应能力类型
30004	请勿重复申请
30005	不满足申请条件
30006	申请信息格式错误
30007	请填写完整申请信息
30008	未找到小程序
30009	请正确填写申请信息-场景描述
40001	参数错误
40003	找不到相关第三方小程序应用
40004	找不到相关授权小程序
40020	第三方小程序应用 authorizer_access_token 不正确或者已过期
40036	授权小程序未授予该接口对应的权限

「抖音直播组件」能力申请审核结果通知

「抖音直播组件」能力申请审核结果出来之后，会自动触发消息发送，然后开放平台服务器会向第三方小程序应用的【消息与事件接收 URL】以 HTTP POST 方式推送相应授权小程序的「抖音直播组件」能力申请的审核结果。

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：代表能力关闭