网站&公众号任务异常检测结果分页查询接口
2024.03.26 10:06:06
网站及公众号任务异常检测结果查询接口，用于查询机器检测结果为嫌疑、不通过的机审结果与人审结果。
接口说明
提供通过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"
}]
}]
}
}
}
}]
}
}
