直播信息提交接口

接口地址

http://as.dun.163.com/v3/livevideo/submit

接口描述

提交视频直播流相关信息接口,信息提交后,易盾会根据客户自己设置的截图频率对直播流进行截图检测,检测结果需产品自行定期调用视频直播结果获取接口获取。

支持格式

检测接口支持的流媒体协议如下:rtp、srtp、rtmp、rtmps、mmsh、mmst、hls、http、tcp、https等。

请求参数

公共参数已省略,详细见 请求公共参数

参数名称类型是否必选最大长度描述
urlStringY512直播流地址
dataIdStringY128直播流唯一标识
versionStringY4接口版本号,可选值 v3.1
callbackStringN512数据回调参数,产品根据业务情况自行设计,当获取离线检测结果时,易盾内容安全服务会返回该字段
scFrequencyNumberN4截图检测频率,默认5秒截图检测一次,可设置范围为0.5~60秒
callbackUrlStringN256离线结果回调通知到客户的URL。主动回调数据接口超时时间设置为2s,为了保证顺利接收数据,需保证接收接口性能稳定并且保证幂等性。
uniqueKeyStringN64客户个性化直播流唯一性标识,传入后,将以此值作为重复检测依据,若不传,默认以URL作为查重依据

响应结果

响应字段如下,响应通用字段已省略,详细见 响应通用字段

参数名称类型描述
taskIdString本次请求数据标识,可以根据该标识查询数据最新结果
statusNumber检测结果,0:成功,1:失败

响应示例

输出结果:

{
    "code": 200,
    "msg": "ok",
   "result": {
		   "taskId": "b82f6eb1de8d478196a73dd552b73226",
		   "status": 0
	       }
}