接口地址

http://as.dun.163.com/v4/image/asyncCheck

接口描述

建议您使用POST请求, 且仅接受 application/x-www-form-urlencoded 编码格式。

如果您对实时性要求不高，可以选择异步检测，其他情况下建议选择同步检测，对于同步检测接口的调用，建议您将超时时间设置为6秒。

图片限制

◆ 目前支持的图片文件格式有：jpg, png, bmp, gif, webp, tiff；

◆ 支持图片大小：单张<10M；

◆ 图片尺寸大小：不小于 50px*50px;

◆ gif图长图说明：易盾自动将gif图长图截帧过检，最多5张，gif图长图均按照实际截图张数进行计费；

◆ 长图定义：长宽比大于5的图片

请求参数

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

基本参数

参数名称	类型	是否必选	最大长度	描述
images	String(json数组)	Y	32张或10MB	images为json数组，支持批量检测
version	String	Y	4	接口版本v4

images参数结构说明

字段名称	类型	是否必选	最大长度	描述
name	String	Y	1024	图片名称(或图片标识)， 该字段为回调信号字段，产品可以根据业务情况自行设计，如json结构、或者为图片url均可
type	Number	Y	4	类型，分别为1：图片URL
data	String	Y	32张	图片内容，如type=1，则该值为图片URL，图片URL检测单次请求最多支持32张
callbackUrl	String	N	256	离线结果回调通知到客户的URL。主动回调数据接口超时时间设置为2s，为了保证顺利接收数据，需保证接收接口性能稳定并且保证幂等性。

业务参数

业务扩展参数，有助于通过业务维度辅助反垃圾结果判定，建议传入。

参数名称	类型	是否必选	最大长度	描述
用户信息	-	N	-	用户信息包含账号、昵称、等级、角色等，请查看 业务扩展参数—用户信息
设备信息	-	N	-	设备信息包含设备ID、设备ID类型等，请查看 业务扩展参数—设备信息
场景信息	-	N	-	场景信息包含私聊、群聊、直播、帖子等场景字段，请查看 业务扩展参数—场景信息
ip	String	N	128	用户IP地址
checkLabels	String数组	N	64	接口指定过检分类，可多选，过检分类列表：100：色情，110：性感低俗，200：广告，210：二维码，300：暴恐，400：违禁，500：涉政，1100：涉价值观

响应结果

响应通用字段

参数名称	类型	描述
code	Number	接口调用状态，200:正常，其他值：调用出错，返回码见 响应返回码
msg	String	结果说明，如果接口调用出错，那么返回错误描述，成功返回 ok
result	数组	返回图片标识和本次请求数据唯一标识

result 数据结构

参数名称	类型	描述
checkImages	数组	返回本次请求数据标识，以及图片标识
dealingCount	Number	缓冲池排队待处理数据量

checkImages数组数据结构

参数名称	类型	描述
name	String	图片名称(或图片标识)
taskId	String	本次请求数据标识，可以根据该标识查询数据最新结果

响应示例

{
    "code": 200,
    "msg": "ok",
    "result": {
        "checkImages": [
            {
                "name": "1234",
                "taskId": "8e0f4a7ffb6d45c2855c336c7111b3e5"
            },
            {
                "name": "1234",
                "taskId": "035b829ddf404829a72640d298a66fd1"
            },
            {
                "name": "1234",
                "taskId": "385d6d8704c7439b817d93482a16e847"
            },
            {
                "name": "1234",
                "taskId": "733cbc44b0254967a8b7375e3dfe6e66"
            }
        ],
        "dealingCount": 0
    }
}