推送模式
2024.09.27 11:14:17
内容安全图片结果获取推送模式用于将图片异步检测或人工审核结果主动推送给客户,保证客户最快的获取结果。客户需要按照以下规范实现接收结果的接口。推送模式与轮询模式互斥,只能选取一种模式进行结果获取。
接口说明
结果主动推送模式以数据为维度,将人工审核结果或者异步机器检测结果推送给客户,需客户在调用检测接口时设置回调地址callbackUrl参数,客户方需保证回调接收接口的可用性和稳定性,确保能正常接收推送过来的结果数据。
鉴权说明
客户接口可以通过业务开通时易盾分配的密钥信息字段进行接口鉴权,鉴权粒度是否要精确到业务级别,用户可以根据需要自行决定,请参见接口鉴权
接入说明
- 协议说明:检测接口请求参数中指定了回调地址参数callbackUrl(即一个http(s)协议接口的URL)。主动推送接口需要支持http协议,支持POST方法,传输数据编码采用utf-8
- 接口性能:推送结果接口默认超时时间为2s,为了保证顺利接收数据,客户需保证接收接口可用性和性能稳定
- 失败重试:客户接口处理结果数据,并返回应答。如果客户接口请求异常,超时或收到的应答不符合规范,易盾会认为推送失败;我们将每隔10分钟推送一次,如果一直失败,持续一天后不再推送
- 幂等性:结果推送时同样的结果可能会多次请求客户接口。客户接口需要保证幂等性,能够正确处理重复结果数据
接口耗时
客户接收接口需保证接收接口可用性和性能稳定,易盾请求超时时间为2s,客户接口尽量保证在1s内返回应答,如有特殊要求,可联系易盾运营适当调整超时时间。
请求
请求地址
名称 | 值 |
---|---|
HTTP URL | 回调地址callbackUrl |
HTTP Method | POST |
请求头
名称 | 类型 | 描述 |
---|---|---|
Content-Type | String | 固定值:"application/x-www-form-urlencoded" |
请求参数
名称 | 类型 | 是否必填 | 最大长度 | 描述 |
---|---|---|---|---|
secretId | String | 是 | 32 | 产品密钥 id ,由易盾内容安全云服务分配,产品标识 |
businessId | String | 是 | 32 | 业务id ,由易盾内容安全云服务分配,业务标识 |
signature | String | 是 | 32 | 请求签名,用来验证此次请求的合法性,具体算法见接口鉴权 |
callbackData | String | 是 | - | 主动推送结果数据,格式为json字符串 |
请求体示例
callbackData=***&signature=xxx&secretId=xxx&businessId=xxx
callbackData为json字符串格式,请自行解析或者转成json对象使用。
人工审核结果请求
resultType为2时表示人工审核结果推送请求,callbackData详细字段信息如下:
名称 | 类型 | 是否返回 | 描述 |
---|---|---|---|
callbackData | Object | 是 | 图片人工审核结果 |
∟ antispam | Object | 是 | 图片内容安全检测结果 |
∟ taskId | String | 是 | 易盾侧机审数据唯一标识,能够根据该值定位到该条数据,如对检测结果有异议,可以发送该值给策略经理查询 |
∟ name | String | 是 | 图片名称(或图片标识) |
∟ dataId | String | 否 | 上传数据唯一标识,能够根据该值定位到该条数据,如对数据结果有异议,可以发送该值给策略经理查询 |
∟ suggestion | Number | 是 | 建议动作,0:通过,2:不通过 |
∟ remark | String | 否 | 人审备注信息 |
∟ resultType | Number | 是 | 结果类型,1:机器结果,2:人审结果 |
∟ labels | Object[] | 是 | 命中的分类信息 |
∟ label | Number | 是 | 分类信息,100:色情,110:性感低俗,200:广告,210:二维码,260:广告法,300:暴恐,400:违禁,500:涉政,800:恶心类,900:其他,1100:涉价值观 |
∟ level | Number | 是 | 命中级别,示例值:1:嫌疑,2:不通过,0:正常,特殊策略下可返回“level=0”的数据,如果需要返回可以找策略经理配置 |
∟ rate | Number | 是 | 置信度分数,0-1之间取值,1为置信度最高,0为置信度最低。若level为正常,置信度越大,说明正常的可能性越高。若level为嫌疑或不通过,置信度越大,说明垃圾的可能性越高 |
∟ censorLabels | Object[] | 否 | 审核标签信息 |
∟ code | String | 是 | 审核标签唯一编号 |
∟ desc | String | 否 | 选择标签填写的备注内容 |
∟ customCode | String | 否 | 自定义审核标签编号 |
∟ name | String | 是 | 审核标签的名称 |
∟overAllMarkDesc | String | 是 | 整体审核备注 |
∟detailMarks | Object[] | 是 | 细节标注 |
∟ position | Object[] | 是 | 标注标签列表 |
∟ x | folat | 是 | 位置信息,对应目标矩形左上角横坐标相对坐标 |
∟ y | float | 是 | 位置信息,对应目标矩形左上角纵坐标相对坐标 |
∟censorLabels | Object[] | 是 | 标注备注 |
∟ code | String | 是 | 审核标签唯一编号 |
∟ desc | String | 否 | 选择标签填写的备注内容 |
∟ name | String | 是 | 审核标签的名称 |
∟ desc | String | 是 | 选择标签填写的备注内容 |
∟ censorSource | Number | 是 | 审核来源,0:易盾人审,1:客户审核,2:易盾机审,3:用户质检,4:易盾质检 |
∟ censorRound | Number | 是 | 审核轮数,普通审核轮数为0。高级审核轮数如下,1:第1轮人审,2:第2轮人审,以此类推,saas人工审核模板配置请参考人工审核模板设置说明文档。若您使用易盾人工审核服务,非必要情况下不要对该字段做解析依赖。人审团队为了您的审核质量,会自发的在某些高风险时段进行多轮审核来保证交付质量,所以该字段可能会在不通知到您的情况下变化,感谢您的配合,有任何问题可以随时联系我们 |
∟ censorTime | Number | 是 | 审核时间 |
人工审核结果请求示例
{
"antispam": {
"taskId": "a2e53718f9c348d09206e4671304ca7c",
"suggestion": 2,
"remark":"人审备注信息,填写才会返回",
"dataId": "dataId",
"name": "name",
"labels": [
{
"label": 400,
"level": 2,
"rate": 1.0
},
{
"label": 500,
"level": 0,
"rate": 1.0
},
{
"label": 300,
"level": 0,
"rate": 1.0
}
],
"censorLabels": [
{
"code": "审核标签编码",
"customCode":"自定义标签编码",
"name": "审核标签名称",
"desc": "风景"
}
],
"resultType": 2,
"censorTime": 1622036595467,
"censorSource": 0,
"censorRound": 1
}
}
异步检测结果请求
resultType为1时表示异步机器检测结果推送请求,callbackData详细字段信息如下:
名称 | 类型 | 是否返回 | 描述 |
---|---|---|---|
callbackData | Object | 是 | 图片检测结果 |
∟ antispam | Object | 是 | 图片内容安全检测结果 |
∟ taskId | String | 是 | 易盾侧机审数据唯一标识,能够根据该值定位到该条数据,如对检测结果有异议,可以发送该值给策略经理查询 |
∟ name | String | 是 | 图片名称(或图片标识) |
∟ dataId | String | 否 | 上传数据唯一标识,能够根据该值定位到该条数据,如对数据结果有异议,可以发送该值给策略经理查询 |
∟ status | Number | 是 | 检测状态,2:检测成功,3:检测失败 |
∟ imgMd5 | String | 是 | 图片MD5 |
∟ failureReason | Number | 否 | 检测失败原因,当status为3(检测失败)时返回:610 图片下载失败、620 图片格式错误、630 其他 |
∟ suggestion | Number | 是 | 建议动作,0:通过,1:嫌疑,2:不通过 |
∟ label | Number | 是 | 命中分类,分类信息,100:色情,200:广告,260:广告法,300:暴恐,400:违禁,500:涉政,600:谩骂,700:灌水,900:其他,1100:涉价值观 |
∟ secondLabel | String | 否 | 命中二级标签细分类 |
∟ thirdLabel | String | 否 | 命中三级标签细分类 |
∟ customAction | Number | 否 | 自定义动作,0:通过,2:不通过。customAction字段用于saas审核系统-机审标准集中的自定义调度功能,将易盾机器检测嫌疑结果通过配置映射为业务自己的自定义动作,可参考图片流程:https://nos.netease.com/yidun/bceb8815e1f50c2339899976e9a2ec28.png |
∟ suggestionLevel | Number | 否 | 嫌疑级别,针对部分定制策略支持命中嫌疑时返回,1:低嫌疑,2:高嫌疑,对通用策略、模型结果暂不支持,v5.2版本新增,默认不返回,如果需要返回请联系策略经理配置 |
∟ resultType | Number | 是 | 结果类型,1:机器结果,2:人审结果 |
∟ frameSize | Number | 是 | 长图、gif图片拆帧后的分帧数,默认为1 |
∟ url | String | 否 | 易盾转存图片oss地址。默认有效期6小时 |
∟ hidden | Boolean | 否 | 是否有隐藏文件,返回需要单独开启,请联系策略经理 |
∟ hiddenFormat | String | 否 | 隐藏文件的格式:mpegts,返回需要单独开启,请联系策略经理 |
∟ labels | Object[] | 是 | 命中的分类信息 |
∟ label | Number | 是 | 分类信息,100:色情,110:性感低俗,200:广告,210:二维码,260:广告法,300:暴恐,400:违禁,500:涉政,800:恶心类,900:其他,1100:涉价值观 |
∟ level | Number | 是 | 命中级别,示例值:1:嫌疑,2:不通过,0:正常,特殊策略下可返回“level=0”的数据,如果需要返回可以找策略经理配置 |
∟ rate | Number | 是 | 置信度分数,0-1之间取值,1为置信度最高,0为置信度最低。若level为正常,置信度越大,说明正常的可能性越高。若level为嫌疑或不通过,置信度越大,说明垃圾的可能性越高 |
∟ subLabels | Object[] | 是 | 细分类信息,可能包含多个 |
∟ hitStrategy | Number | 是 | 用于区分本次机器审核的命中原因:0:图片内容,1:图片上的文字 |
∟ subLabel | String | 是 | 细分类,详细编码请参考下方对应细分类编码 对照表 |
∟ rate | Number | 是 | 置信度分数,0-1之间取值,1为置信度最高,0为置信度最低 |
∟ details | Object | 否 | 命中的详细对象信息 |
∟ keywords | Object[] | 否 | 命中的自定义敏感词信息 |
∟ word | String | 是 | 敏感词内容 |
∟ x1 | Number | 否 | 位置信息,对应目标矩形左上角横坐标相对坐标 |
∟ y1 | Number | 否 | 位置信息,对应目标矩形左上角纵坐标相对坐标 |
∟ x2 | Number | 否 | 位置信息,对应目标矩形右下角横坐标相对坐标 |
∟ y2 | Number | 否 | 位置信息,对应目标矩形右下角纵坐标相对坐标 |
∟ libInfos | Object[] | 是 | 命中的自定义图片名单信息 |
∟ type | Number | 是 | 1:自定义用户名单,2:自定义ip名单,3:自定义设备名单,4:自定义图片名单,目前只支持返回4自定义图片名单 |
∟ entity | String | 是 | 该图片命中自定义图片名单对应原始添加的根源图片url |
∟ releaseTime | Number | 是 | 名单解封时间,时间戳单位毫秒 |
∟ hitCount | Number | 是 | 历史针对该数据源图片命中所有次数 |
∟ value | String | 否 | 图片中包含的可识别内容 |
∟ group | String | 否 | value对应的分组名称,用于对value的解释 |
∟ hitInfos | Object[] | 是 | 命中的线索信息 |
∟ value | String | 是 | 图片中包含的可识别内容 |
∟ group | String | 否 | value对应的分组名称,用于对value的解释 |
∟ x1 | Number | 否 | 位置信息,对应目标矩形左上角横坐标相对坐标 |
∟ y1 | Number | 否 | 位置信息,对应目标矩形左上角纵坐标相对坐标 |
∟ x2 | Number | 否 | 位置信息,对应目标矩形右下角横坐标相对坐标 |
∟ y2 | Number | 否 | 位置信息,对应目标矩形右下角纵坐标相对坐标 |
∟ anticheat | Object | 否 | 命中的反作弊信息 |
∟ hitType | Number | 是 | 反作弊命中类型,详见hitType返回码及含义表 |
∟ rules | Object[] | 否 | 命中用户自定义的规则信息 |
∟ name | String | 是 | 规则名 |
∟ ocr | Object | 否 | OCR结果信息,OCR功能需额外付费开启,如有需要请联系您的专属商务,未开通状态下不返回 |
∟ taskId | String | 是 | 易盾侧机审数据唯一标识,能够根据该值定位到该条数据,如对检测结果有异议,可以发送该值给策略经理查询 |
∟ name | String | 是 | 图片名称(或图片标识) |
∟ dataId | String | 否 | 上传数据唯一标识,能够根据该值定位到该条数据,如对数据结果有异议,可以发送该值给策略经理查询 |
∟ height | Number | 是 | 图片高度,单位像素 |
∟ width | Number | 是 | 图片宽度,单位像素 |
∟ frameSize | Number | 是 | 长图、gif图片拆帧后的分帧数,默认为1 |
∟ details | Object[] | 否 | 命中的详细信息 |
∟ content | String | 是 | 该图片中所有的文字信息集合 |
∟ lineContents | Object[] | 是 | OCR行信息 |
∟ lineContent | String | 是 | 每行的文字信息 |
∟ lang | String | 否 | 语种信息 |
∟ x1 | Number | 否 | 位置信息,对应目标矩形左上角横坐标相对坐标 |
∟ y1 | Number | 否 | 位置信息,对应目标矩形左上角纵坐标相对坐标 |
∟ x2 | Number | 否 | 位置信息,对应目标矩形右下角横坐标相对坐标 |
∟ y2 | Number | 否 | 位置信息,对应目标矩形右下角纵坐标相对坐标 |
∟ face | Object | 否 | 人脸检测信息,人脸检测结果需额外付费开启,如有需要请联系您的专属商务,未开通状态下不返回 |
∟ taskId | String | 是 | 易盾侧机审数据唯一标识,能够根据该值定位到该条数据,如对检测结果有异议,可以发送该值给策略经理查询 |
∟ name | String | 是 | 图片名称(或图片标识) |
∟ dataId | String | 否 | 上传数据唯一标识,能够根据该值定位到该条数据,如对数据结果有异议,可以发送该值给策略经理查询 |
∟ details | Object[] | 否 | 命中的详细信息 |
∟ faceNumber | Number | 是 | 该图片中包含的人脸个数 |
∟ deepfake | Integer | 否 | 是否有伪造人脸,0:无,1:有 |
∟ faceContents | Object[] | 是 | 人脸详细信息 |
∟ name | String | 是 | 图片中出现的人脸名字,未识别则为空。该字段可识别明星、政治人物等人脸信息,用于落马官员/劣迹艺人检测,或明星头像/政治头像检测 |
∟ glasses | String | 是 | 人脸戴眼镜,normal(无眼镜)、 glasses(普通眼镜)、 sunglasses(墨镜),如有需要请联系您的专属商务,未开通状态下不返回该字段 |
∟ gender | String | 否 | 人脸性别,值为男(male)、女(female);不可识别则为空 |
∟ age | Number | 否 | 人脸年龄,值为具体年龄(age);不可识别则为空 |
∟ growthStage | String | 否 | 成长阶段(未成年,成年),值为child(未成年幼态),young(非幼态未成年),adult(成年) |
∟ type | String | 否 | 人脸类型,包含卡通脸(cartoon)、普通(normal),如有需要请联系您的专属商务,未开通状态下不返回该字段 |
∟ category | String | 否 | 人物分类,包含名人(star)、普通(normal)、海外娱乐明星(overseaEntertainmentStar)、海外体育明星(overseaSportStar)、海外政客(overseaPolitician)、海外网红(overseaInternetStar) |
∟maskType | String | 否 | mask(有遮挡),normal(无遮挡)。判断人脸是否有遮挡,可以用于判断用户是否佩戴口罩墨镜纱巾等综合性遮挡场景 |
∟expression | String | 否 | 人脸情绪:neutral(扮酷),happy(微笑),sad(悲伤),surprise(惊讶),fear(害怕),anger(生气),disgust(不喜欢),如有需要请联系您的专属商务,未开通状态下不返回该字段 |
∟ completeness | Number | 否 | 人脸完整性,0:不完整,1:完整,2:未知,如有需要请联系您的专属商务,未开通状态下不返回该字段 |
∟ beautyScore | Number | 否 | 人脸颜值分数,0-1,保留4位小数,如有检测需求请联系易盾策略经理开启服务,如有需要请联系您的专属商务,未开通状态下不返回该字段 |
∟ sizeRatio | String | 否 | 人脸占比,百分比形式 |
∟ x1 | Number | 否 | 位置信息,对应目标矩形左上角横坐标相对坐标 |
∟ y1 | Number | 否 | 位置信息,对应目标矩形左上角纵坐标相对坐标 |
∟ x2 | Number | 否 | 位置信息,对应目标矩形右下角横坐标相对坐标 |
∟ y2 | Number | 否 | 位置信息,对应目标矩形右下角纵坐标相对坐标 |
∟ quality | Object | 否 | 图片质量检测结果,图片质量检测结果需额外付费开启,如有需要请联系您的专属商务,未开通状态下不返回 |
∟ taskId | String | 是 | 易盾侧机审数据唯一标识,能够根据该值定位到该条数据,如对检测结果有异议,可以发送该值给策略经理查询 |
∟ name | String | 是 | 图片名称(或图片标识) |
∟ dataId | String | 否 | 上传数据唯一标识,能够根据该值定位到该条数据,如对数据结果有异议,可以发送该值给策略经理查询 |
∟ details | Object[] | 否 | 命中的详细信息 |
∟ aestheticsRate | Number | 否 | 美观度分数,0-1,分数越高美观度越高,建议0.5分以上可认为美观度较好,0.3分以下可认为美观度较差,具体视业务场景而定 |
∟ sharpnessRate | Number | 否 | 清晰度分数,0-1,分数越高清晰度越高,建议0.5分以上可认为清晰度较好,0.3分以下可认为清晰度较差,具体视业务场景而定 |
∟ metaInfo | Object | 否 | 图片基本信息 |
∟ byteSize | Number | 否 | 图片大小,单位byte |
∟ format | String | 否 | 图片格式 |
∟ height | Number | 否 | 图片高度,单位像素 |
∟ width | Number | 否 | 图片宽度,单位像素 |
∟ hiddenPlayer | Boolean | 否 | 是否隐藏播放器,返回需要单独开启,请联系策略经理 |
∟ boarderInfo | Object | 否 | 图片背景信息 |
∟ hit | Boolean | 否 | 图片是否包含边框(任一边包含边框均视为包含)true:包含边框;false:不包含边框 |
∟ top | Boolean | 否 | 图片顶部是否包含边框,true:包含边框;false:不包含边框 |
∟ right | Boolean | 否 | 图片右侧是否包含边框,true:包含边框;false:不包含边框 |
∟ bottom | Boolean | 否 | 图片底部是否包含边框,true:包含边框;false:不包含边框 |
∟ left | Boolean | 否 | 图片左侧是否包含边框,true:包含边框;false:不包含边框 |
∟ backgroundInfo | Object | 否 | 图片背景信息 |
∟ pureBackground | Boolean | 否 | 纯色背景检测,true:背景纯色;false:背景复杂 |
∟ logo | Object | 否 | logo检测结果,logo检测支持对图片中包含的通识logo进行识别,检测结果返回需额外付费开启,如有需要请联系您的专属商务,未开通状态下不返回 |
∟ taskId | String | 是 | 易盾侧机审数据唯一标识,能够根据该值定位到该条数据,如对检测结果有异议,可以发送该值给策略经理查询 |
∟ name | String | 是 | 图片名称(或图片标识) |
∟ dataId | String | 否 | 上传数据唯一标识,能够根据该值定位到该条数据,如对数据结果有异议,可以发送该值给策略经理查询 |
∟ details | Object[] | 否 | 命中的详细信息 |
∟ logoName | String | 是 | logo名字,不可识别则为空 |
∟ x1 | Number | 否 | logo位置信息,对应logo矩形左上角横坐标相对坐标 |
∟ y1 | Number | 否 | logo位置信息,对应logo矩形左上角纵坐标相对坐标 |
∟ x2 | Number | 否 | logo位置信息,对应logo矩形右下角横坐标相对坐标 |
∟ y2 | Number | 否 | logo位置信息,对应logo矩形右下角纵坐标相对坐标 |
∟ rate | String | 否 | 置信度分数 ,置信度0-1,越接近1,置信度越高 |
∟ sizeRatio | String | 否 | logo占百分比大小 |
∟ aigc | Object | 否 | aigc检测结果,如有需要请联系您的专属商务,未开通状态下不返回 |
∟ taskId | String | 是 | 易盾侧机审数据唯一标识,能够根据该值定位到该条数据,如对检测结果有异议,可以发送该值给策略经理查询 |
∟ name | String | 是 | 图片名称(或图片标识) |
∟ dataId | String | 否 | 上传数据唯一标识,能够根据该值定位到该条数据,如对数据结果有异议,可以发送该值给策略经理查询 |
∟ details | Object[] | 否 | 命中的详细信息 |
∟ isAigc | boolean | 是 | true:是aigc;false:非aigc |
∟ discern | Object | 否 | 图片个性化内容识别结果,识别检测支持对图片中物体进行识别,识别结果返回需额外付费开启,如有需要请联系您的专属商务,未开通状态下不返回 |
∟ taskId | String | 是 | 易盾侧机审数据唯一标识,能够根据该值定位到该条数据,如对检测结果有异议,可以发送该值给策略经理查询 |
∟ name | String | 是 | 图片名称(或图片标识) |
∟ dataId | String | 否 | 上传数据唯一标识,能够根据该值定位到该条数据,如对数据结果有异议,可以发送该值给策略经理查询 |
∟ details | Object[] | 否 | 命中的详细信息 |
∟ discernName | String | 是 | 识别物体名称 |
∟ discernKey | String | 是 | 识别标识 |
∟ label | String | 否 | 大模型识别标签(同步检测不支持,只支持异步检测返回 ) |
∟explain | String | 否 | 大模型识别解释 (同步检测不支持,只支持异步检测返回 ) |
∟ rate | Number | 是 | 识别分数,0-1之间取值,1为置信度最高,0为置信度最低。 |
∟ type | Number | 是 | 图片识别类型,1 场景识别,2 地标识别,3 通用识别,4:乐谱识别,5:动漫识别,6:服饰识别,7:地图截图识别,8:聊天截屏识别,9:手机识别,10:举白纸识别,11:哺乳照识别,12:可爱卡通骷髅识别 ,13:广告表情包识别,14:睡播识别,100:客户自训练模型 |
∟ userRisk | Object | 否 | 图片用户画像识别结果,用户画像识别返回需额外付费开启,如有需要请联系您的专属商务,未开通状态下不返回 |
∟ taskId | String | 是 | 易盾侧机审数据唯一标识,能够根据该值定位到该条数据,如对检测结果有异议,可以发送该值给策略经理查询 |
∟ name | String | 是 | 图片名称(或图片标识) |
∟ dataId | String | 否 | 上传数据唯一标识,能够根据该值定位到该条数据,如对数据结果有异议,可以发送该值给策略经理查询 |
∟ account | String | 是 | 账号信息 |
∟ details | Object[] | 否 | 命中的详细信息 |
∟ account | String | 是 | 账号信息 |
∟ acDetails | Object[] | 是 | 命中的详细信息 |
∟ riskType | String | 否 | yin_liu_hei_chan(引流黑产),qi_zha_xian_yi(欺诈嫌疑),she_jiao_la_ren(社交拉人) |
∟ riskLevel | Number | 否 | 账号等级,0:低风险,1:中风险,2:高风险 |
∟ riskScore | String | 否 | 风险分值:0-1 |
∟ anticheat | Object | 否 | 图片反作弊检测结果,如有需要请联系您的专属商务,未开通状态下不返回 |
∟ taskId | String | 是 | 易盾侧机审数据唯一标识,能够根据该值定位到该条数据,如对检测结果有异议,可以发送该值给策略经理查询 |
∟ dataId | String | 是 | 上传数据唯一标识,能够根据该值定位到该条数据,如对数据结果有异议,可以发送该值给策略经理查询 |
∟ details | Object[] | 否 | 命中的详细信息 |
∟ suggestion | Number | 是 | 检测结果,0:通过,10:嫌疑,20:不通过 |
∟ hitInfos | Object[] | 是 | 命中信息 |
∟ hitType | Number | 是 | 反作弊命中类型,详见hitType返回码及含义表 |
∟ hitMsg | String | 是 | 反作弊命中详情,可定制返回值 |
∟ riskControl | Object | 否 | 智能风控检测结果,如有需要请联系您的专属商务,未开通状态下不返回 |
∟ taskId | String | 是 | 易盾侧机审数据唯一标识,能够根据该值定位到该条数据,如对检测结果有异议,可以发送该值给策略经理查询 |
∟ dataId | String | 是 | 上传数据唯一标识,能够根据该值定位到该条数据,如对数据结果有异议,可以发送该值给策略经理查询 |
∟ details | Object[] | 否 | 智能风控命中详情 |
∟ riskLevel | Number | 是 | 风险等级:0 正常,1 低风险,2 中风险,3 高风险,4 可信源。 风险等级只会返回一个,取本次命中的最高风险等级 |
∟ hitInfos | Object[] | 否 | 备注 |
∟ type | String | 是 | 命中的风险标签编号 |
∟ name | String | 是 | 命中的风险标签对应的名称,命中的标签的上下级名称采用‘-’进行拼接 |
异步检测结果请求示例
{
"antispam": {
"taskId": "cb047f822b444668ad90453fbd4d88f4",
"status": 2,
"imgMd5":"587a7628ee57485863287eabb41d7dd2",
"suggestion": 2,
"suggestionLevel":2,
"dataId": "dataId",
"name": "name",
"resultType": 1,
"frameSize":1,
"labels": [
{
"label": 500,
"level": 2,
"rate": 1.0,
"subLabels": [
{
"hitStrategy":0,
"subLabel": 50003,
"rate": 1.0,
"details": {
"keywords": [
{
"word": "自定义敏感词",
"x1": 0.0473,
"y1": 0.0362,
"x2": 0.1964,
"y2": 0.1530
}
],
"libInfos": [
{
"entity": "自定义图片名单url",
"hitCount": 3,
"value": "可识别内容",
"group": "可识别内容分组"
}
],
"hitInfos": [
{
"value": "可识别内容",
"group": "可识别内容分组",
"x1": 0.0473,
"y1": 0.0362,
"x2": 0.1964,
"y2": 0.1530
}
],
"anticheat": {
"hitType": 1
}
}
}
]
},
{
"label": 300,
"level": 2,
"rate": 1.0,
"subLabels": [
{
"subLabel": 30003,
"rate": 1.0
},
{
"subLabel": 30002,
"rate": 0.99499786
}
]
},
{
"label": 400,
"level": 2,
"rate": 1.0,
"subLabels": [
{
"subLabel": 40007,
"rate": 1.0
},
{
"subLabel": 40003,
"rate": 0.984296
}
]
}
]
},
"ocr": {
"taskId": "cb047f822b444668ad90453fbd4d88f4",
"dataId": "dataId",
"name": "name",
"height": 730,
"width": 572,
"frameSize":1,
"details": [
{
"content": "唐新唐人电视台NEWTANGDYNASTYTELEVISIONRFA",
"lineContents": [
{
"lineContent": "唐",
"x1": 0.0473,
"y1": 0.0362,
"x2": 0.1964,
"y2": 0.1530,
"lang": "zh"
}
]
}
]
},
"face": {
"taskId": "cb047f822b444668ad90453fbd4d88f4",
"name": "0",
"dataId": "dataId",
"details": [
{
"faceNumber": 3,
"faceContents": [
{
"name": "艾力更·依明巴海",
"glasses":"normal",
"x1": 0.0473,
"y1": 0.0362,
"x2": 0.1964,
"y2": 0.1530,
"type": "normal",
"category": "normal",
"gender": "male",
"age": 59,
"sizeRatio": "1.74%"
}
]
}
]
},
"quality": {
"taskId": "cb047f822b444668ad90453fbd4d88f4",
"name": "name",
"dataId": "dataId",
"details": [
{
"aestheticsRate": 0.466,
"sharpnessRate": 0.511,
"metaInfo": {
"byteSize": 355357,
"height": 730,
"width": 572,
"format": "png"
},
"boarderInfo": {
"hit": false,
"top": false,
"right": false,
"bottom": false,
"left": false
},
"backgroundInfo": {
"pureBackground": false
}
}
]
},
"logo": {
"taskId": "cb047f822b444668ad90453fbd4d88f4",
"name": "name",
"dataId": "dataId",
"details": [
{
"logoName": "RFA",
"x1": 0.5611,
"y1": 0.7369,
"x2": 0.8444,
"y2": 0.9506,
"rate":0.9742,
"sizeRatio":"2.7%"
}
]
},
"discern": {
"taskId": "cb047f822b444668ad90453fbd4d88f4",
"name": "name",
"dataId": "dataId",
"details": [
{
"type": 1,
"discernName": "泳池",
"discernKey": "pool",
"rate": 0.5611
}
]
},
"anticheat": {
"taskId": "fx6sxdcd89fvbvg4967b4787d78a",
"dataId": "dataId",
"details": [
{
"suggestion": 20,
"hitInfos": [
{
"hitType": 5,
"hitMsg": "无SDK数据"
}
]
}
]
},
"userRisk": {
"taskId": "cb047f822b444668ad90453fbd4d88f4",
"name": "name",
"dataId": "dataId",
"account": "account",
"details": [
{
"account": "account",
"acDetails":[
{
"riskType":"qi_zha_xian_yi",
"riskLevel":1,
"riskScore":0.6
}
]
}
]
}
}
响应
响应结果
- 客户接口接收到我们回调的结果后,需要返回应答信息,接口响应HTTP状态码为200,当回调处理异常时,应答的HTTP状态码应为500,或者4xx;
- 目前推送方式默认连接超时(connect timeout)150ms,回调超时(socket timeout)为2s,建议收到推送检测结果后,优先返回response应答信息,异步处理检测结果,避免因为回调超时,易盾侧未收到响应重复推送结果。如业务侧对于超时配置有特殊要求,可联系易盾策略经理调整配置。
- 应答信息为json格式,字段定义如下:
名称 | 类型 | 是否返回 | 描述 |
---|---|---|---|
code | Number | 是 | 应答code,易盾方解析code为200表示推送成功 |
msg | String | 否 | 具体描述信息 |
响应体示例
{
"code": 200,
"msg": "接收成功"
}