2.4 回调接口.md 2.57 KB

接口描述

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

请求方式: HTTP POST


接口说明: 第三方业务提供接口地址,在申请appId的同时在统一平台进行注册。

请求参数说明:

参数名 参数类型 必选 参数说明
data string true 活动 json 数据 (业务系统创建活动时的参数)
status string true 操作符 -2:异常中断、0:直播未开始、1:直播开始、2:正常结束、3:活动数据更新

data 参数说明

参数名 参数类型 必选 参数说明
appId string(20) true 应用ID
activityId string(32) true 活动ID,确保SP下的唯一性(即appId唯一)
activityName string(64) true 活动名称
activityStatus int true 活动状态,0:未开始 /1:已开始 /3:已结束 /4 已下线,默认为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字符串(主播昵称、头像、)

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