直播信息提交接口
2022.05.18 09:55:55
接口地址
http://as.dun.163.com/v3/livevideo/submit
接口描述
提交视频直播流相关信息接口,信息提交后,易盾会根据客户自己设置的截图频率对直播流进行截图检测,检测结果需产品自行定期调用视频直播结果获取接口获取。建议您使用POST请求, 且仅接受 application/x-www-form-urlencoded 编码格式。
支持格式
检测接口支持的流媒体协议如下:rtp、srtp、rtmp、rtmps、mmsh、mmst、hls、http、tcp、https等。
请求参数
公共参数已省略,详细见 请求公共参数
参数名称 | 类型 | 是否必选 | 最大长度 | 描述 |
---|---|---|---|---|
url | String | Y | 1024 | 直播流地址 |
dataId | String | Y | 128 | 直播流唯一标识 |
version | String | Y | 4 | 接口版本号,可选值 v3.1 |
callback | String | N | 512 | 数据回调参数,产品根据业务情况自行设计,当获取离线检测结果时,易盾内容安全服务会返回该字段 |
scFrequency | Number | N | 4 | 截图检测频率,默认5秒截图检测一次,可设置范围为0.5~600秒 |
callbackUrl | String | N | 256 | 离线结果回调通知到客户的URL。主动回调数据接口超时时间设置为2s,为了保证顺利接收数据,需保证接收接口性能稳定并且保证幂等性。 |
uniqueKey | String | N | 64 | 客户个性化直播流唯一性标识,传入后,将以此值作为重复检测依据,若不传,默认以URL作为查重依据 |
响应结果
响应字段如下,响应通用字段已省略,详细见 响应通用字段 :
参数名称 | 类型 | 描述 |
---|---|---|
taskId | String | 本次请求数据标识,可以根据该标识查询数据最新结果 |
status | Number | 检测结果,0:成功,1:失败 |
响应示例
输出结果:
{
"code": 200,
"msg": "ok",
"result": {
"taskId": "b82f6eb1de8d478196a73dd552b73226",
"status": 0
}
}