音视频解决方案提交接口

接口地址

http://as.dun.163.com/v1/videosolution/submit

接口描述

提交音视频的URL进行检测,建议您使用POST请求, 且仅接受 application/x-www-form-urlencoded 编码格式。

查看v1.2提交接口文档

大小限制

视频大小限制:<5G。

请求参数

公共参数已省略,详细见 请求公共参数,businessId可不传,其他参数如下:

参数名称类型是否必选最大长度描述
dataIdStringN128数据唯一标识,能够根据该值定位到该条数据,如对数据结果有异议,可以发送该值给客户经理查询
versionStringY4接口版本v1.3
ipStringN128用户IP地址
accountStringN128用户唯一标识,如果无需登录则为空
deviceIdStringN128用户设备 id,与易盾设备画像库匹配,明文请转大写传入;MD5加密请明文转大写后MD5计算,再转大写传入,建议抄送
deviceTypeNumberN4用户设备id的类型,0:其他,10:IMEI,11:AndroidID,12:IDFA,13:IDFV,14:MAC ,20:IMEI_MD5,21:AndroidID_MD5,22:IDFA_MD5,23:IDFV_MD5,24:MAC_MD5
urlStringY1024音视频url
titleStringN512音视频标题,传入后自动进行反垃圾检测
imagesString(json数组)N10张或5MB音视频封面/简介图片,images为json数组,支持批量检测,传入后自动进行反垃圾检测
contentStringN1000音视频简介,传入后自动进行反垃圾检测
detectTypeNumberN1机器过检类型,15:视频与音频同时过检,14:仅过检视频,13:仅过检音频,不填写默认为15,请注意
scFrequencyNumberN4截图检测频率,默认5秒截图检测一次,可设置范围为0.5~60秒
callbackStringN512数据回调参数,调用方根据业务情况自行设计,当调用文本离线结果获取接口时,该接口会原样返回该字段。作为数据处理标识,因此该字段应该设计为能唯一定位到该次请求的数据结构,如对用户的昵称进行检测,dataId可设为用户标识(用户ID),用户修改多次,每次请求数据的dataId可能一致,但是callback参数可以设计成定位该次请求的数据结构,比如callback字段设计成json,包含dataId和请求的时间戳等信息,当然如果不想做区分,也可以直接把callback设置成dataId的值。
callbackUrlStringN1024离线结果回调通知到客户的URL。主动回调数据接口超时时间设置为2s,为了保证顺利接收数据,需保证接收接口性能稳定并且保证幂等性。
uniqueKeyStringN64客户个性化唯一性标识,传入后,将以此值作为重复检测依据,若不传,默认以URL作为查重依据,此参数在v1.2以上版本支持请注意version传入,如果重复提交会被拒绝,返回报错信息请求重复,以及原提交taskID值,具体返回请查看响应示例

images 数据结构

参数名称类型是否必选最大长度描述
nameStringY1024图片名称(或图片标识), 该字段为回调信号字段,产品可以根据业务情况自行设计,如json结构、或者为图片url均可
typeNumberY4类型,分别为1:图片URL,2:图片BASE64值
dataStringY10张或5MB图片内容,如type=1,则该值为图片URL,如type=2,则该值为图片BASE64值。图片URL检测单次请求最多支持10张,图片BASE64值检测单次请求大小限制为最多5MB

响应结果

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

result 数据结构

参数名称类型描述
taskIdString本次请求数据标识,可以根据该标识查询数据最新结果
dataIdString数据唯一标识,能够根据该值定位到该条数据,如对数据结果有异议,可以发送该值给客户经理查询

响应示例

{
    "code": 200,
    "msg": "ok",
    "result": {
            "taskId": "******",
            "dataId": "******"
        }
}

重复检测返回结构

1.uniqueKey提交重复

2.如果不传uniqueKey默认以url做判断,如若当前有正在检测的url,重复检测按照失败返回

{
    "code":417,
    "msg":"返回原提交taskID值"
 }