接口描述
- 直播活动创建、开始、结束,通过该回调接口通知第三方业务系统
- 业务系统在创建活动时提供接口地址
请求方式: HTTP POST
接口说明: 第三方业务提供接口地址,在申请appId的同时在统一平台进行注册。
请求参数说明:
| 参数名 |
参数类型 |
必选 |
参数说明 |
| data |
string |
true |
活动 json 数据 (业务系统创建活动时的参数) |
data 参数说明
| 参数名 |
参数类型 |
必选 |
参数说明 |
| appId |
string(20) |
true |
应用ID |
| activityId |
string(32) |
true |
活动ID,确保SP下的唯一性(即appId唯一) |
| activityName |
string(64) |
true |
活动名称 |
| activityStatus |
int |
true |
活动状态,0:直播前;1:直播中;2:直播结束;3:回放准备中;4:回放;5:直播下线;-2:直播异常;默认为0 |
| isHorizontalScreen |
int |
true |
屏幕方向,0:垂直即竖屏 /1:水平即横屏 ,默认为1 | |
| channelId |
string(32) |
true |
播放通道;PGC业务:平台分配/ UGC业务:主播ID生成,确保SP下的唯一性 |
| startTime |
string |
false |
开始时间,格式yyyyMMddHHmmss |
| endTime |
string |
false |
开始时间,格式yyyyMMddHHmmss |
| duration |
int |
false |
时长 单位 秒,活动正常结束时该字段有值 |
| coverImgUrl |
string(512) |
false |
活动封面 |
| activityCategory |
string |
false |
活动分类ID,999 -未知/001 发布会/002 婚礼/003 年会 /004 体育/005 游戏/006 旅游&户外/007 财经/008 演唱会/009 烹饪/010 宠物&动物/011 访谈/012 教育/013 竞技/014 剧场/015 晚会/016 电视节目/017 秀场 |
| extensions |
string(text) |
false |
扩展字段,参数格式为Map对象的Json字符串(主播昵称、头像、) |
| showType |
int |
false |
显示类型,1;//图片2;//预告片3;//直播4;//回放 |
| vId |
String |
false |
显示类型2;预告片4;回放 时,点播内容标识 |
data 格式
{
activityName: "",
activityStatus:"",
startTime: 2016-08-23 10:37:38,
endTime: null,
description: null,
coverImgUrl: "",
activityCategory:"",
extensions: "",
uuid:"",
isHorizontalScreen: 1,
createTime: "2016-08-23 10:37:38",
activityId: "1471919861222",
appId: "60_irg1rhs308",
channelId:"",
duration:2323
}
返回结果 json
{
"errorMessage":"成功",
"errorCode":"0"
}