2.4 回调接口.md 2.66 KB

接口描述

  • 直播活动创建、开始、结束,通过该回调接口通知第三方业务系统
  • 业务系统在创建活动时提供接口地址

请求方式: 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"
   }