网站&公众号任务异常检测结果分页查询接口
2023.09.28 11:34:44
网站及公众号任务异常检测结果查询接口,用于查询机器检测结果为嫌疑、不通过的机审结果与人审结果。
接口说明
提供通过jobId来分页查询任务检测结果的功能,需要客户根据jobId主动调用接口来获取结果。支持最近7天范围内的检测数据结果查询。
鉴权说明
易盾内容安全服务使用签名方法对接口进行鉴权,所有接口每一次请求都需要包含签名信息(signature 参数),以验证用户身份,防止信息被恶意篡改。目前支持MD5,SHA1,SHA256,SM3几种加密算法,详细信息,请参见接口鉴权
结果说明
- 支持最近7天范围内的数据查询
- 接口请求频率限制为20次/min(每分钟20次),过快服务器会拒绝处理,客户可以根据业务需求进行适当调整
接口耗时
任务检测结果查询接口正常200ms内返回结果,业务方根据需求适当调整超时时间,建议为1s
请求
请求地址
名称 | 值 |
---|---|
HTTP URL | https://as.dun.163.com/v1/crawler/callback-result/query |
HTTP Method | POST |
请求头
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
Content-Type | String | 是 | 固定值:"application/x-www-form-urlencoded" |
请求参数
请求参数由公共参数和业务参数两部分组成,公共参数见请求公共参数
名称 | 类型 | 必填 | 最大长度 | 描述 |
---|---|---|---|---|
version | String | 是 | 4 | 接口版本,当前版本为v1.0 |
jobId | Number | 是 | 创建任务时返回的jobid | |
pageSize | Number | 否 | 风险url列表分页大小,范围20到50,默认20 | |
pageNum | Number | 否 | 风险url列表页数,默认1 |
请求体示例
version=v1.0
&jobId=123456
&pageSize=20
&pageNum=1
&signature=xxx&secretId=xxx
响应
响应字段如下,响应通用字段已省略,详细见 响应公共字段
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
result | Object | 是 | 检测结果 |
∟rows | Object[] | 是 | 检测结果列表 |
∟count | Object | 是 | 网页或公众号文章机器检测结果 |
rows中数据对象字段如下
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
∟rows | Object[] | 是 | 检测结果 |
∟antispam | Object | 否 | 机器检测结果 |
∟censor | Object | 否 | 人工审核检测结果 |
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
rows | Object[] | 是 | 检测机器审核结果 |
∟antispam | Object | 是 | 网页或文章机器检测结果 |
∟taskId | String | 是 | 本次请求数据标识,可以根据该标识查询数据最新结果 |
∟dataId | String | 否 | 上传数据唯一标识,能够根据该值定位到该条数据,如对数据结果有异议,可以发送该值给客户经理查询 |
∟callback | String | 否 | 数据回调参数,请求参数中传来的callback字段原样返回 |
∟resourceType | Number | 是 | 检测资源类型,1-网站数据,2-公众号数据 |
∟url | String | 否 | 网页或公众号文章url |
∟suggestion | Number | 是 | 建议动作,0:通过,1:嫌疑,2:不通过 |
∟failureReason | Number | 否 | 检测失败原因,当检测失败时才会返回该字段;1:爬虫失败;2:试用量超限;3:业务已关闭;4:爬取内容为空;5:连接失败;6:404网页不存在;7:URL正在爬取,请勿同时重复提交;100:其他原因 |
∟resultType | Number | 是 | 结果类型,1:机器结果,2:人审结果 |
∟checkStatus | Number | 是 | 检测状态, 1:检测中 2:检测成功 3:检测失败 |
∟evidences | Object | 否 | 机审证据信息 |
∟texts | Object[] | 否 | 文本检测结果 |
∟ dataId | String | 否 | 上传数据唯一标识,能够根据该值定位到该条数据,如对数据结果有异议,可以发送该值给客户经理查询 |
∟ field | String | 是 | 数据来源字段名。当数据来自提交接口的 content 时,此字段值为 content,当数据来自提交接口自定义字段时,此字段值为自定义字段名 |
∟ suggestion | Number | 是 | 建议动作,0:通过,1:嫌疑,2:不通过 |
∟ resultType | Number | 是 | 结果类型,1:机器结果,2:人审结果 |
∟ censorType | Number | 是 | 审核模式,0:纯机审,1:机审+部分人审,2:机审+全量人审 |
∟ strategyVersions | Object[] | 否 | 策略版本号,策略更新时该参数会更新,可用于追溯策略调优效果 |
∟ label | Number | 是 | 分类,示例值:100 |
∟ version | String | 是 | 版本号 |
∟ isRelatedHit | Boolean | 是 | 是否关联检测命中,true:关联检测命中,false:原文命中 |
∟ labels | Object[] | 是 | 命中的分类信息 |
∟ label | Number | 是 | 命中分类,分类信息,100:色情,200:广告,260:广告法,300:暴恐,400:违禁,500:涉政,600:谩骂,700:灌水,900:其他,1100:涉价值观 |
∟ level | Number | 是 | 命中级别,示例值:1:嫌疑,2:不通过,0:正常,特殊策略下可返回“level=0”的数据,如果需要返回可以找策略经理配置 |
∟ subLabels | Object[] | 否 | 细分类信息,可能包含多个 |
∟ subLabel | String | 是 | 细分类,详细编码请参考下方对应细分类编码[对照表] |
∟ details | Object | 否 | 命中的详细信息 |
∟ keywords | Object[] | 否 | 命中的敏感词信息 |
∟ word | String | 是 | 敏感词内容 |
∟ libInfos | Object[] | 否 | 命中的自定义库信息 |
∟ type | Number | 是 | 库类型,1:自定义用户名单库,2:自定义ip名单库 |
∟ entity | String | 是 | 自定义库实体 |
∟ hintInfos | Object[] | 否 | 命中的线索信息 |
∟ value | String | 是 | 线索内容 |
∟ positions | Object[] | 是 | 线索位置 |
∟ startPos | Number | 是 | 线索开始坐标 |
∟ endPos | Number | 是 | 线索结束坐标 |
∟ images | Object[] | 否 | 图片检测结果 |
∟ imageUrl | String | 是 | 风险图片下载地址 |
∟ dataId | String | 否 | 上传数据唯一标识,能够根据该值定位到该条数据,如对数据结果有异议,可以发送该值给客户经理查询 |
∟ field | String | 是 | 数据来源字段名。当数据来自提交接口的 content 时,此字段值为 content,当数据来自提交接口自定义字段时,此字段值为自定义字段名 |
∟ name | String | 是 | 图片名称(或图片标识) |
∟ status | Number | 是 | 检测状态:2 检测成功、3 检测失败 |
∟ failureReason | Number | 否 | 检测失败原因,当status为3(检测失败)时返回:610 图片下载失败、620 图片格式错误、630 检测成功、630 其他 |
∟ suggestion | Number | 是 | 建议动作,0:通过,1:嫌疑,2:不通过 |
∟ 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为不确定或确定,置信度越大,说明垃圾的可能性越高 |
∟ subLabels | Object[] | 是 | 细分类信息,可能包含多个 |
∟ subLabel | String | 是 | 细分类,详细编码请参考下方对应细分类编码[对照表] |
∟ rate | Number | 是 | 置信度分数,0-1之间取值,1为置信度最高,0为置信度最低 |
∟ details | Object | 否 | 命中的详细对象信息 |
∟ keywords | Object[] | 否 | 命中的自定义敏感词信息 |
∟ word | string | 是 | 敏感词内容 |
∟ x1 | Number | 否 | 位置信息,对应目标矩形左上角横坐标相对坐标 |
∟ y1 | Number | 否 | 位置信息,对应目标矩形左上角纵坐标相对坐标 |
∟ x2 | Number | 否 | 位置信息,对应目标矩形右下角横坐标相对坐标 |
∟ y2 | Number | 否 | 位置信息,对应目标矩形右下角纵坐标相对坐标 |
∟ libInfos | Object[] | 是 | 命中的自定义图片名单信息 |
∟ entity | String | 是 | 该图片命中自定义图片名单对应原始添加的根源图片url |
∟ hitCount | String | 是 | 历史针对该数据源图片命中所有次数 |
∟ value | String | 否 | 图片中包含的可识别内容 |
∟ group | String | 否 | value对应的分组名称,用于对value的解释 |
∟ hintInfos | Object[] | 是 | 命中的线索信息 |
∟ value | String | 是 | 图片中包含的可识别内容 |
∟ group | String | 否 | value对应的分组名称,用于对value的解释 |
∟ x1 | Number | 否 | 位置信息,对应目标矩形左上角横坐标相对坐标 |
∟ y1 | Number | 否 | 位置信息,对应目标矩形左上角纵坐标相对坐标 |
∟ x2 | Number | 否 | 位置信息,对应目标矩形右下角横坐标相对坐标 |
∟ y2 | Number | 否 | 位置信息,对应目标矩形右下角纵坐标相对坐标 |
人工审核结果
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
rows | Object[] | 是 | 人工审核结果 |
∟ censor | Object | 是 | 人工审核结果,接入人工审核后,才会返回此信息 |
∟ taskId | String | 是 | 本次请求数据标识,可以根据该标识查询数据最新结果 |
∟ dataId | String | 否 | 上传数据唯一标识,能够根据该值定位到该条数据,如对数据结果有异议,可以发送该值给客户经理查询 |
∟ callback | String | 否 | 数据回调参数,请求参数中传来的callback字段原样返回 |
∟url | String | 否 | 网页或者公众号文章URL |
∟resourceType | Number | 是 | 检测资源类型,1-网站数据,2-公众号数据 |
∟siteName | String | 是 | 网站名称 |
∟siteUrl | String | 是 | 主站地址 |
∟ suggestion | Number | 是 | 建议动作,0:通过,1:嫌疑,2:不通过 |
∟ resultType | Number | 是 | 结果类型,1:机器结果,2:人审结果 |
∟ censorTime | Number | 是 | 审核时间,毫秒单位的时间戳 |
∟ censorSource | Number | 是 | 审核来源,0:系统人审,1:客户审核,2:系统机审,3:用户质检,4:系统质检 |
∟ censorLabels | Object[] | 否 | 审核标签信息 |
∟ code | String | 是 | 审核标签标签唯一编号 |
∟ name | String | 是 | 审核标签的名称 |
∟ desc | String | 否 | 选择标签填写的备注内容 |
∟ reviewEvidences | Object[] | 否 | 人审证据信息 |
∟ reason | String | 否 | 判定原因 |
∟ remark | String | 否 | 备注信息 |
∟ detail | Object | 否 | 人审证据详细信息 |
∟ texts | Object[] | 否 | 文本证据信息 |
∟ reasons | Object[] | 否 | 文本判定原因 |
∟ text | String | 否 | 人审标注文本 |
∟ reason | String | 否 | 文本判定原因 |
∟ censorLabels | Object[] | 否 | 审核标签信息 |
∟ code | String | 是 | 审核标签标签唯一编号 |
∟ name | String | 是 | 审核标签的名称 |
∟ desc | String | 否 | 选择标签填写的备注内容 |
∟ images | Object[] | 否 | 图片证据信息 |
∟ reasons | Object[] | 否 | 图片判定原因 |
∟ url | String | 否 | 人审标注图片url |
∟ reason | String | 否 | 图片判定原因 |
∟ censorLabels | Object[] | 否 | 审核标签信息 |
∟ code | String | 是 | 审核标签标签唯一编号 |
∟ name | String | 是 | 审核标签的名称 |
∟ desc | String | 否 | 选择标签填写的备注内容 |
响应示例
{
"code": 200,
"msg": "ok",
"result": {
"count": 1,
"rows": [{
"antispam": {
"checkStatus": 2,
"dataId": "123",
"url": "网页或公众号文章url",
"resourceType": 2,
"suggestion": 2,
"callback": "i am callback",
"evidences": {
"images": [{
"dataId": "525875",
"field": "content",
"suggestion": 2,
"censorType": 0,
"name": "mp84l9cwy8eqfxydqnx53vug05009pgw",
"resultType": 1,
"labels": [{
"subLabels": [{
"subLabel": "50003",
"rate": 1,
"details": {
"hitInfos": [{
"y1": 0.1756,
"y2": 0.7165,
"x1": 0.1711,
"x2": 0.8457,
"value": "李四"
}]
}
}],
"level": 2,
"rate": 1,
"label": 500
},
{
"level": 0,
"rate": 1,
"label": 300
}
],
"status": 2
}],
"texts": [{
"dataId": "216292",
"field": "content",
"suggestion": 2,
"censorType": 0,
"isRelatedHit": false,
"resultType": 1,
"labels": [{
"subLabels": [{
"subLabel": "100080",
"details": {
"hitInfos": [{
"positions": [{
"fieldName": "content",
"startPos": 0,
"endPos": 2
}],
"value": "测试"
}],
"keywords": [{
"word": "测试"
}]
}
},
{
"subLabel": "100002"
}
],
"level": 2,
"label": 100
},
{
"subLabels": [{
"subLabel": "500001",
"details": {
"hitInfos": [{
"positions": [{
"fieldName": "content",
"startPos": 15,
"endPos": 18
}],
"value": "测试"
}]
}
},
{
"subLabel": "500015"
}
],
"level": 2,
"label": 500
},
{
"level": 0,
"label": 200
}
]
}],
"audios": [{
"duration": 25000,
"checkTime": 1630485845599,
"dataId": "330957",
"field": "content",
"suggestion": 2,
"resultType": 1,
"segments": [{
"startTime": 0,
"endTime": 25,
"type": 0,
"content": "测试文本测试文本",
"labels": [{
"subLabels": [{
"subLabel": "500013",
"details": {
"hitInfos": [{
"value": "测试"
},
{
"value": "测,测试"
}
]
}
}],
"level": 2,
"label": 500
}]
}],
"status": 2
}],
"audiovideos": [{
"duration": 71339,
"checkTime": 1630485848287,
"dataId": "709664",
"field": "content",
"suggestion": 2,
"evidences": {
"audio": {
"duration": 71,
"suggestion": 2,
"resultType": 1,
"segments": [{
"startTime": 12,
"endTime": 17,
"type": 1,
"content": "命中声纹检测",
"labels": [{
"subLabels": [{
"subLabel": "13000",
"details": {
"hitInfos": [{
"value": "1.00"
}]
}
}],
"level": 2,
"label": 100
}]
},
{
"startTime": 15,
"endTime": 20,
"type": 1,
"content": "命中声纹检测",
"labels": [{
"subLabels": [{
"subLabel": "13000",
"details": {
"hitInfos": [{
"value": "1.00"
}]
}
}],
"level": 2,
"label": 100
}]
}
],
"status": 2
},
"video": {
"duration": 71,
"suggestion": 2,
"resultType": 1,
"pictures": [{
"backPics": [{
"url": "https://123.jpg"
}],
"frontPics": [{
"url": "https://456.jpg"
}],
"startTime": 5000,
"endTime": 5000,
"type": 1,
"url": "789.jpg",
"labels": [{
"subLabels": [{
"subLabel": "10007",
"rate": 0.926,
"details": {
"hitInfos": [{
"value": "卡通色情",
"group": "色情部位分组"
}]
}
}],
"level": 2,
"rate": 0.95157,
"label": 100
}]
}],
"status": 2
}
},
"resultType": 1,
"status": 2
}]
},
"resultType": 1,
"taskId": "mp84l9cwy8eqfxydqnx53vug05009pgw"
},
"censor": {
"dataId": "1636374310837",
"taskId": "9208ba146279470c90aba8cf9b7128a6",
"url": "网页或公众号文章url",
"siteUrl": "网站",
"siteName": "网站名",
"suggestion": 2,
"resultType": 2,
"censorSource": 0,
"censorTime": 1636374466354,
"censorLabels": [{
"code": "1600762076926",
"name": "地球",
"customCode": "shabis",
"desc": ""
},
{
"code": "1600759147543",
"name": "变形金刚",
"desc": ""
}
],
"reviewEvidences": {
"reason": "色情",
"remark": "备注",
"detail": {
"images": [{
"reasons": [{
"censorLabels": [
],
"reason": "违规图片",
"url": "https://image.jpg"
}]
}],
"texts": [{
"reasons": [{
"censorLabels": [
],
"reason": "违规文本",
"text": "异常的的异常"
}]
}],
"audios": [{
"reasons": [{
"censorLabels": [
],
"reason": "音频违规",
"startTime": 0,
"endTime": 0,
"url": "https://audio.mp3"
}]
}],
"files": [{
"texts": [{
"censorLabels": [
],
"reason": "违规文本",
"text": "异常的的异常"
}],
"images": [{
"censorLabels": [
],
"reason": "违规图片",
"url": "https://image.jpg"
}]
}],
"videos": [{
"reasons": [{
"censorLabels": [
],
"reason": "视频中图片违规",
"startTime": 0,
"endTime": 0,
"url": "https://video.mp4"
}]
}],
"audiovideos": [{
"audios": [{
"censorLabels": [
],
"reason": "音频违规",
"startTime": 0,
"endTime": 0,
"url": "https://video.mp4"
}],
"videos": [{
"censorLabels": [
],
"reason": "视频中图片违规",
"startTime": 0,
"endTime": 0,
"url": "https://video.mp4"
}]
}]
}
}
}
}]
}
}