轮询模式
2024.09.02 17:59:14
获取网站、微信公众号文章、微博主贴检测离线检测结果,客户可以通过轮询调用该接口获取数据。轮询模式与推送模式互斥,只能选取一种模式进行结果获取。
接口说明
该接口返回网站、微信公众号文章、微博主贴检测离线检测结果,需要客户通过该接口进行定时轮询获取,当提交检测接口参数 callbackUrl 为空时,表示结果通过该接口获取,结果可以根据提交检测时返回的 taskId 对应。
鉴权说明
易盾内容安全服务使用签名方法对接口进行鉴权,所有接口每一次请求都需要包含签名信息(signature 参数),以验证用户身份,防止信息被恶意篡改。目前支持 MD5、SHA1、SHA256、SM3 几种加密算法,详细信息,请参见接口鉴权
结果说明
- 获取结果后,下次调用,不会再次返回之前获取过的结果
- 接口一次最多返回50个结果,结果数据默认保留7天,7天不获取会失效
- 接口请求频率应小于1s/10次,过快服务器会拒绝处理,客户可以根据业务需求进行适当调整
接口耗时
结果获取接口的响应很快,正常50ms内返回结果,业务方根据需求适当调整超时时间,建议为1s
历史版本
请求
请求地址
名称 | 值 |
---|---|
HTTP URL | https://as.dun.163.com/v3/crawler/callback/results |
HTTP Method | POST |
请求头
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
Content-Type | String | 是 | 固定值:"application/x-www-form-urlencoded" |
请求参数
请求参数由公共参数和业务参数两部分组成
公共参数
公共参数包含密钥信息和参数签名信息,公共参数详细见请求公共参数
业务参数
名称 | 类型 | 必填 | 最大长度 | 描述 |
---|---|---|---|---|
version | String | 是 | 4 | 接口版本,当前版本为v3.0 |
请求体示例
version=v3.0&signature=xxx&secretId=xxx
响应
该接口返回网站检测异步检测结果,响应字段如下,响应通用字段已省略,详细见 响应公共字段。
异步检测结果
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
result | Object[] | 是 | 网站检测机器审核结果 |
∟antispam | Object | 是 | 网站页面机器检测结果 |
∟taskId | String | 是 | 本次请求数据标识,可以根据该标识查询数据最新结果 |
∟dataId | String | 否 | 数据唯一标识,能够根据该值定位到该条数据,如对数据结果有异议,可以发送该值给策略经理查询 |
∟callback | String | 否 | 数据回调参数,请求参数中传来的callback字段原样返回 |
∟url | String | 否 | 网页URL(指定主站域名下具体的网页URL) |
∟siteUrl | String | 否 | 主站URL |
∟siteName | String | 否 | 网站名 |
∟suggestion | Number | 是 | 建议动作,0:通过,1:嫌疑,2:不通过 |
∟resourceType | Number | 是 | 资源类型, 1:网站数据,2:公众号数据,3:微博数据 |
∟failureReason | Number | 否 | 网站检测失败原因,当检测失败时才会返回该字段;1:爬虫失败;2:试用量超限;3:业务已关闭;4:爬取内容为空;5:连接失败;6:404网页不存在;7:URL正在爬取,请勿同时重复提交;100:其他原因 |
∟resultType | Number | 是 | 结果类型,1:机器结果,2:人审结果 |
∟checkStatus | Number | 是 | 检测状态, 1:检测中 2:检测成功 3:检测失败 |
∟md5 | String | 否 | 网页提取内容的md5值 |
∟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 |
∟ subLabels | Object[] | 否 | 细分类信息,可能包含多个 |
∟ subLabel | String | 是 | 细分类,详细编码请参考下方对应细分类编码对照表 |
∟ details | Object | 否 | 命中的详细信息 |
∟ keywords | Object[] | 否 | 命中的敏感词信息 |
∟ word | String | 是 | 敏感词内容 |
∟ libInfos | Object[] | 否 | 命中的自定义库信息 |
∟ type | Number | 是 | 库类型,1:自定义用户名单库,2:自定义ip名单库 |
∟ entity | String | 是 | 自定义库实体 |
∟ hitInfos | 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:人审结果 |
∟ censorType | Number | 是 | 审核模式,0:纯机审,1:机审+部分人审,2:机审+全量人审 |
∟ labels | Object[] | 是 | 命中的分类信息 |
∟ label | Number | 是 | 分类信息,100:色情,110:性感低俗,200:广告,210:二维码,260:广告法,300:暴恐,400:违禁,500:涉政,800:恶心类,900:其他,1100:涉价值观 |
∟ level | Number | 是 | 分类级别,0:正常,1:不确定,2:确定 |
∟ 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的解释 |
∟ hitInfos | Object[] | 否 | 命中的线索信息 |
∟ value | String | 是 | 图片中包含的可识别内容 |
∟ group | String | 否 | value对应的分组名称,用于对value的解释 |
∟ x1 | Number | 否 | 位置信息,对应目标矩形左上角横坐标相对坐标 |
∟ y1 | Number | 否 | 位置信息,对应目标矩形左上角纵坐标相对坐标 |
∟ x2 | Number | 否 | 位置信息,对应目标矩形右下角横坐标相对坐标 |
∟ y2 | Number | 否 | 位置信息,对应目标矩形右下角纵坐标相对坐标 |
∟ audios | Object[] | 否 | 音频检测结果 |
∟ audioUrl | String | 是 | 风险音频下载地址 |
∟ dataId | String | 否 | 检测子数据数据唯一标识 |
∟ field | String | 是 | 数据来源字段名。当数据来自提交接口的 content 时,此字段值为content,当数据来自提交接口自定义字段时,此字段值为自定义字段名 |
∟ status | Number | 是 | 检测状态,2:检测成功,3:检测失败 |
∟ suggestion | Number | 是 | 建议结果 0:通过,1:嫌疑,2:删除 |
∟ resultType | Number | 是 | 结果类型 1:机器结果,2:人审结果 |
∟ duration | Number | 是 | 音视频时长字段,单位:秒 |
∟ checkTime | Number | 是 | 机器检测结束时间,毫秒单位的时间戳形式(2021.1.1 01:00转换时间戳1609434000000) |
∟ segments | Object[] | 是 | 音频数据所在断句详细信息 |
∟ startTime | Number | 是 | 断句开始时间点,单位秒 |
∟ endTime | Number | 是 | 断句结束时间点,单位秒 |
∟ type | Number | 是 | 断句类型,0-语音识别,1-声纹检测 |
∟ content | String | 是 | 音频数据所在断句语音识别原文内容,支持返回异常数据所在断句内容或全部原文内容 |
∟ labels | Object[] | 是 | 分类信息 |
∟ label | Number | 是 | 分类信息,分类信息,100:色情,200:广告,260:广告法,300:暴恐,400:违禁,500:涉政,600:谩骂,1100:涉价值观 |
∟ level | Number | 是 | 分类级别,0:通过,1:嫌疑,2:不通过 |
∟ subLabels | Object[] | 否 | 命中细分类信息 |
∟ subLabel | String | 是 | 细分类,详细编码请参考细分类编码对应表 |
∟ details | Object | 是 | 其他信息 |
∟ hitInfo | Object[] | 是 | 证据信息 |
∟ value | String | 是 | 命中的敏感词或者声纹检测的分值 |
∟ keywords | Object[] | 否 | 自定义敏感词线索分类信息 |
∟ word | String | 是 | 自定义添加敏感词 |
∟ libInfos | Object[] | 否 | 自定义名单线索分类信息 |
∟ listType | Number | 是 | 名单类型 |
∟ entity | String | 是 | 名单内容 |
∟ audiovideos | Object[] | 否 | 视频检测结果 |
∟ videoUrl | String | 是 | 风险视频下载地址 |
∟ dataId | String | 否 | 检测子数据数据唯一标识 |
∟ field | String | 是 | 数据来源字段名。当数据来自提交接口的 content 时,此字段值为content,当数据来自提交接口自定义字段时,此字段值为自定义字段名 |
∟ status | Number | 是 | 检测状态,2:检测成功,3:检测失败 |
∟ suggestion | Number | 是 | 建议结果 0:通过,1:嫌疑,2:删除 |
∟ resultType | Number | 是 | 结果类型 1:机器结果,2:人审结果 |
∟ duration | Number | 是 | 音视频时长字段,单位:秒 |
∟ checkTime | Number | 是 | 机器检测结束时间,毫秒单位的时间戳形式(2021.1.1 01:00转换时间戳1609434000000) |
∟ evidences | Object | 否 | 机器检测结果 |
∟ audio | Object | 否 | 视频中的音频机器检测结果 |
∟ duration | Number | 是 | 音频时长字段,单位:秒 |
∟ suggestion | Number | 是 | 建议结果 0:通过,1:嫌疑,2:删除 |
∟ resultType | Number | 是 | 结果类型 1:机器结果,2:人审结果 |
∟ status | Number | 是 | 检测状态,2:检测成功,3:检测失败 |
∟ segments | Object[] | 是 | 音频数据所在断句详细信息 |
∟ startTime | Number | 是 | 断句开始时间点,单位秒 |
∟ endTime | Number | 是 | 断句结束时间点,单位秒 |
∟ type | Number | 是 | 断句类型,0-语音识别,1-声纹检测 |
∟ content | String | 是 | 音频数据所在断句语音识别原文内容,支持返回异常数据所在断句内容或全部原文内容 |
∟ labels | Object[] | 是 | 分类信息 |
∟ label | Number | 是 | 分类信息,分类信息,100:色情,200:广告,260:广告法,300:暴恐,400:违禁,500:涉政,600:谩骂,1100:涉价值观 |
∟ level | Number | 是 | 分类级别,0:通过,1:嫌疑,2:不通过 |
∟ subLabels | Object[] | 否 | 命中细分类信息 |
∟ subLabel | String | 是 | 细分类,详细编码请参考细分类编码对应表] |
∟ details | Object | 是 | 其他信息 |
∟ hitInfo | Object[] | 是 | 证据信息 |
∟ value | String | 是 | 命中的敏感词或者声纹检测的分值 |
∟ keywords | Object[] | 否 | 自定义敏感词线索分类信息 |
∟ word | String | 是 | 自定义添加敏感词 |
∟ libInfos | Object[] | 否 | 自定义名单线索分类信息 |
∟ listType | Number | 是 | 名单类型 |
∟ entity | String | 是 | 名单内容 |
∟ video | Object | 否 | 视频机器检测结果 |
∟ duration | Number | 是 | 视频时长字段,单位:秒 |
∟ suggestion | Number | 是 | 建议结果 0:通过,1:嫌疑,2:删除 |
∟ resultType | Number | 是 | 结果类型 1:机器结果,2:人审结果 |
∟ status | Number | 是 | 检测状态,2:检测成功,3:检测失败 |
∟ pictures | Object[] | 否 | 截图证据信息 |
∟ type | Number | 是 | 截图类型,1:图片,2:视频 |
∟ url | String | 是 | 截图下载地址 |
∟ startTime | Number | 是 | 证据开始相对时间,单位为毫秒,调用方获取后可自行格式化为可视化时间,如:149000 转换为"00:02:29" |
∟ endTime | Number | 是 | 证据结束相对时间,单位为毫秒,调用方获取后可自行格式化为可视化时间,如:149000 转换为"00:02:29" |
∟ frontPics | Object[] | 否 | 关联信息-命中前截图信息 |
∟ url | String | 是 | 命中前截图下载地址 |
∟ backPics | Object[] | 否 | 关联信息-命中后截图信息 |
∟ url | String | 是 | 命中前截图下载地址 |
∟ labels | Object[] | 是 | 命中的分类信息 |
∟ label | Number | 是 | 分类信息,100:色情,110:性感低俗,200:广告,210:二维码,260:广告法,300:暴恐,400:违禁,500:涉政,800:恶心类,900:其他,1100:涉价值观 |
∟ level | Number | 是 | 分类级别,0:正常,1:不确定,2:确定 |
∟ 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的解释 |
∟ hitInfos | Object[] | 否 | 命中的线索信息 |
∟ value | String | 是 | 图片中包含的可识别内容 |
∟ group | String | 否 | value对应的分组名称,用于对value的解释 |
∟ x1 | Number | 否 | 位置信息,对应目标矩形左上角横坐标相对坐标 |
∟ y1 | Number | 否 | 位置信息,对应目标矩形左上角纵坐标相对坐标 |
∟ x2 | Number | 否 | 位置信息,对应目标矩形右下角横坐标相对坐标 |
∟ y2 | Number | 否 | 位置信息,对应目标矩形右下角纵坐标相对坐标 |
∟ files | Object[] | 否 | 文档检测结果 |
∟ fileUrl | String | 是 | 风险文档下载地址 |
∟ dataId | String | 否 | 检测子数据数据唯一标识 |
∟ field | String | 是 | 数据来源字段名。当数据来自提交接口的 content 时,此字段值为content,当数据来自提交接口自定义字段时,此字段值为自定义字段名 |
∟ suggestion | Number | 是 | 建议动作,0:通过,1:嫌疑,2:不通过 |
∟ resultType | Number | 是 | 结果类型,1:机器结果,2:人审结果 |
∟ evidences | Object | 否 | 机审证据信息 |
∟ texts | Object[] | 否 | 文本证据信息 |
∟ taskId | String | 是 | 当前分段检测数据标识 |
∟ sequence | Number | 是 | 当前文本在原始文档中的分段(5000字符/段)序号 |
∟ startText | String | 是 | 每段文本的起始20个字符 |
∟ endText | String | 是 | 每段文本的结尾20个字符 |
∟ suggestion | Nunber | 是 | 建议动作,0:通过,1:嫌疑,2:不通过 |
∟ page | Nunber | 是 | 证据文本所在文档页码,目前仅对pdf格式生效,返回pdf文档对应页码 |
∟ labels | Object[] | 是 | 命中的分类信息 |
∟ label | Nunber | 是 | 命中分类,示例值:100 |
∟ level | Nunber | 是 | 命中级别,示例值:1 |
∟ subLabels | Object[] | 是 | 细分类信息,可能包含多个,具体数据结构如下 |
∟ subLabel | String | 是 | 细分类,详细编码请参考下方对应细分类编码对照表 |
∟ details | Object | 否 | 命中的详细信息 |
∟ keywords | Object[] | 否 | 命中的敏感词信息 |
∟ word | String | 是 | 敏感词内容 |
∟ libInfos | Object[] | 否 | 命中的自定义库信息 |
∟ type | Number | 是 | 库类型,1:自定义用户名单库,2:自定义ip名单库 |
∟ entity | String | 是 | 自定义库实体 |
∟ hitInfos | Object[] | 否 | 命中的线索信息 |
∟ value | String | 是 | 线索内容 |
∟ positions | Object[] | 是 | 线索位置 |
∟ fieldName | String | 是 | 位置类型,content:正文,title:标题 |
∟ startPos | Number | 是 | 线索开始坐标 |
∟ endPos | Number | 是 | 线索结束坐标 |
∟ images | Object[] | 否 | 图片证据信息 |
∟ sequence | Number | 是 | 当前图片在原始文档中的序号 |
∟ imageUrl | String | 是 | 图片下载地址 |
∟ suggestion | Number | 是 | 分类级别,0:正常,1:不确定,2:确定 |
∟ page | Nunber | 是 | 证据图片所在文档页码,目前仅对pdf格式生效,返回pdf文档对应页码 |
∟ labels | Object[] | 是 | 命中的分类信息 |
∟ label | Nunber | 是 | 分类信息,100:色情,110:性感低俗,200:广告,210:二维码,260:广告法,300:暴恐,400:违禁,500:涉政,800:恶心类,900:其他,1100:涉价值观 |
∟ level | Nunber | 是 | 分类级别,0:正常,1:不确定,2:确定 |
∟ rate | Nunber | 是 | 置信度分数,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的解释 |
∟ hitInfos | Object[] | 是 | 命中的线索信息 |
∟ value | String | 是 | 图片中包含的可识别内容 |
∟ group | String | 否 | value对应的分组名称,用于对value的解释 |
∟ x1 | Number | 否 | 位置信息,对应目标矩形左上角横坐标相对坐标 |
∟ y1 | Number | 否 | 位置信息,对应目标矩形左上角纵坐标相对坐标 |
∟ x2 | Number | 否 | 位置信息,对应目标矩形右下角横坐标相对坐标 |
∟ y2 | Number | 否 | 位置信息,对应目标矩形右下角纵坐标相对坐标 |
∟valueAddService | Object | 是 | 增值服务信息,如有检测需求请联系易盾策略经理开启服务 |
∟ emotionAnalysis | Object | 否 | 情感分析检测结果 |
∟ texts | Object[] | 否 | 文本情感分析检测结果 |
∟ taskId | String | 是 | 检测任务ID |
∟ field | String | 是 | 数据来源字段名 |
∟ dataId | String | 是 | 数据ID |
∟ details | Object[] | 否 | 命中的详细信息 |
∟ positiveProb | Number | 是 | 正向情绪倾向,取值0-1,分数越高,正向情绪越高 |
∟ negativeProb | Number | 是 | 负向情绪倾向,取值0-1,分数越高,负向情绪越高 |
∟ sentiment | String | 是 | 情感类型,negative(负向情绪),neutral(中性情绪),positive(正向情绪),unknown(未知) |
∟ language | Object | 否 | 语种检测结果 |
∟ texts | Object[] | 否 | 文本语种检测结果 |
∟ taskId | String | 是 | 检测任务ID |
∟ field | String | 是 | 数据来源字段名 |
∟ dataId | String | 是 | 数据ID |
∟ details | Object[] | 否 | 命中的详细信息 |
∟ type | String | 是 | 语种代码详见,语种代码表 |
∟ ocr | Object | 否 | OCR结果信息 |
∟ images | Object[] | 否 | 图片OCR结果信息 |
∟ taskId | String | 是 | 检测任务ID |
∟ field | String | 是 | 数据来源字段名 |
∟ dataId | String | 否 | 数据唯一标识 |
∟ height | Number | 是 | 图片高度,单位像素 |
∟ width | Number | 是 | 图片宽度,单位像素 |
∟ details | Object[] | 否 | 命中的详细信息 |
∟ content | String | 是 | 该图片中所有的文字信息集合 |
∟ lineContents | Object[] | 是 | OCR行信息 |
∟ lineContent | String | 是 | 每行的文字信息 |
∟ lang | String | 否 | 语种信息 |
∟ x1 | Number | 否 | 位置信息,对应目标矩形左上角横坐标相对坐标 |
∟ y1 | Number | 否 | 位置信息,对应目标矩形左上角纵坐标相对坐标 |
∟ x2 | Number | 否 | 位置信息,对应目标矩形右下角横坐标相对坐标 |
∟ y2 | Number | 否 | 位置信息,对应目标矩形右下角纵坐标相对坐标 |
∟ face | Object | 否 | 人脸检测信息 |
∟ images | Object[] | 否 | 图片人脸检测信息 |
∟ taskId | String | 是 | 检测任务ID |
∟ field | String | 是 | 数据来源字段名 |
∟ dataId | String | 否 | 数据唯一标识 |
∟ details | Object[] | 否 | 命中的详细信息 |
∟ faceNumber | Number | 是 | 该图片中包含的人脸个数 |
∟ deepfake | Integer | 否 | 是否有伪造人脸,0:无,1:有;如有需要请联系您的专属商务,未开通状态下不返回该字段 |
∟ faceContents | Object[] | 是 | 人脸详细信息 |
∟ name | String | 是 | 人脸名字,不可识别则为空 |
∟ gender | String | 否 | 人脸性别,值为男(male)、女(female);不可识别则为空 |
∟ age | Integer | 否 | 人脸年龄,值为具体年龄(age);不可识别则为空 |
∟ type | String | 否 | 人脸类型,包含卡通脸(cartoon)、普通(normal) |
∟ category | String | 否 | 人物分类,包含名人(star)、普通(normal) |
∟ glasses | String | 是 | 人脸戴眼镜,normal(无眼镜)、 glasses(普通眼镜)、 sunglasses(墨镜),如有需要请联系您的专属商务,未开通状态下不返回该字段 |
∟ growthStage | String | 否 | 成长阶段(未成年,成年),值为child(未成年幼态),young(非幼态未成年),adult(成年),,如有需要请联系您的专属商务,未开通状态下不返回该字段 |
∟ beautyScore | Number | 否 | 人脸颜值分数,0-1,保留4位小数,如有检测需求请联系易盾策略经理开启服务,如有需要请联系您的专属商务,未开通状态下不返回该字段 |
∟ expression | String | 否 | 人脸情绪:neutral(扮酷),happy(微笑),sad(悲伤),surprise(惊讶),fear(害怕),anger(生气),disgust(不喜欢),如有需要请联系您的专属商务,未开通状态下不返回该字段 |
∟ completeness | Number | 否 | 人脸完整性,0:不完整,1:完整,2:未知,如有需要请联系您的专属商务,未开通状态下不返回该字段 |
∟ poseInfoList | Object[] | 否 | 人脸角度,如有需要请联系您的专属商务,未开通状态下不返回该字段 |
∟ label | String | 否 | 旋转角度类型。pitch是俯仰角,是“点头“,即绕x轴上下旋转;yaw是偏航角,是“摇头”,即绕y轴左右旋转;roll是滚转角,是“摆头”,即绕z轴平面旋转 |
∟ angle | Number | 否 | 旋转角度,-99~99,如-11.84 |
∟ sizeRatio | String | 否 | 人脸占比,百分比形式 |
∟ x1 | Number | 否 | 位置信息,对应目标矩形左上角横坐标相对坐标 |
∟ y1 | Number | 否 | 位置信息,对应目标矩形左上角纵坐标相对坐标 |
∟ x2 | Number | 否 | 位置信息,对应目标矩形右下角横坐标相对坐标 |
∟ y2 | Number | 否 | 位置信息,对应目标矩形右下角纵坐标相对坐标 |
∟ imageQuality | Object | 否 | 图片质量检测结果 |
∟ images | Object[] | 否 | 图片质量检测结果 |
∟ taskId | String | 是 | 检测任务ID |
∟ field | 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 | 否 | 图片宽度,单位像素 |
∟ boarderInfo | Object | 否 | 图片背景信息 |
∟ hit | Boolean | 否 | 图片是否包含边框(任一边包含边框均视为包含)ture:包含边框;false:不包含边框 |
∟ top | Boolean | 否 | 图片顶部是否包含边框,ture:包含边框;false:不包含边框 |
∟ right | Boolean | 否 | 图片右侧是否包含边框,ture:包含边框;false:不包含边框 |
∟ bottom | Boolean | 否 | 图片底部是否包含边框,ture:包含边框;false:不包含边框 |
∟ left | Boolean | 否 | 图片左侧是否包含边框,ture:包含边框;false:不包含边框 |
∟ backgroundInfo | Object | 否 | 图片背景信息 |
∟ pureBackground | boolean | 否 | 纯色背景检测,ture:背景纯色;false:背景复杂 |
∟ logo | Object | 否 | logo检测结果,logo检测支持对图片中包含的通识logo进行识别 |
∟ images | Object[] | 否 | 图片logo检测结果 |
∟ taskId | String | 是 | 检测任务ID |
∟ field | String | 是 | 数据来源字段名 |
∟ dataId | String | 否 | 数据唯一标识 |
∟ details | Object[] | 否 | 命中的详细信息 |
∟ logoName | String | 是 | logo名字,不可识别则为空 |
∟ x1 | Number | 否 | logo位置信息,对应logo矩形左上角横坐标相对坐标 |
∟ y1 | Number | 否 | logo位置信息,对应logo矩形左上角纵坐标相对坐标 |
∟ x2 | Number | 否 | logo位置信息,对应logo矩形右下角横坐标相对坐标 |
∟ y2 | Number | 否 | logo位置信息,对应logo矩形右下角纵坐标相对坐标 |
∟ imageDiscern | Object | 否 | 图片识别结果 |
∟ images | Object[] | 否 | 图片识别结果 |
∟ taskId | String | 是 | 检测任务ID |
∟ field | String | 是 | 数据来源字段名 |
∟ dataId | String | 否 | 数据唯一标识 |
∟ details | Object[] | 否 | 命中的详细信息 |
∟ discernName | String | 是 | 识别物体名称 |
∟ rate | Number | 是 | 识别分数,0-1之间取值,1为置信度最高,0为置信度最低。 |
∟ type | Number | 是 | 图片识别类型,1 场景识别,2 地标识别,3 通用识别 |
∟ grammarFix | Object | 否 | 文本纠错结果信息 |
∟ texts | Object[] | 否 | 文本内容的纠错结果信息 |
∟ taskId | String | 是 | 检测任务ID |
∟ field | String | 是 | 数据来源字段名 |
∟ dataId | String | 否 | 上传数据唯一标识,能够根据该值定位到该条数据,如对数据结果有异议,可以发送该值给策略经理查询 |
∟ level | Number | 是 | 纠错结果标识,0: 无错误,1: 有错误 |
∟ details | Object[] | 否 | 纠错详情 |
∟ correctContent | String | 是 | 纠错结果 |
∟ fragments | Object[] | 是 | 纠错片段 |
∟ oriWord | String | 是 | 原错误词 |
∟ correctWord | String | 否 | 错误修正词,仅针对可修改错误类型有效 |
∟ headWord | String | 否 | 错误依赖词,仅针对不可修改错误类型有效 |
∟ label | String | 是 | 基础版一级错误分类,E100: 常识性错误,E300: 语法错误,E400: 多字少字错误,E500: 涉政错误,E600: 敏感词检查,E900: 自定义错误 |
∟ subLabel | String | 否 | 基础版二级错误分类,可能为空,E100001: 字词错误,E100002: 人名错误,E100003: 地名错误,E400001: 多字,E400002: 少字,E500001: 领土主权错误,E500002: 职务搭配错误,E500003: 国家机构搭配错误,E900000: 纠错词典 |
∟ inspectType | String | 否 | 高级版错误分类,unknow(未知)、errorwords(易错词)、sentivewords(敏感词)、"variantchar(异体字)punctuation(标点符号)、traditionalchinese(简体繁体误用)、terms(不规范名词)、leadersort(领导人排序错误)、leadertitle(领导人职务错误)、keywords(重点词)、translation(译文检测)、ADtime(公元纪年错误)、historytime(历史纪年错误)、branchtime(干支纪年错误)、placenameused(地名曾用名检测)、placenamematch(新旧地名不符)、placenamedivision(地名所属区划错误) |
∟ modifiedType | Number | 是 | 错误类型,0: 可修改错误,1: 不可修改错误 |
∟ startPos | Number | 是 | 开始索引位置 |
∟ endPos | Number | 是 | 结束索引位置 |
∟ headStartPos | Number | 是 | 不可修改错误的相关关键词开始位置 |
∟ headEndPos | Number | 是 | 不可修改错误的相关关键词结束位置 |
∟ correctSuggestion | String | 是 | 当modifiedType=1时返回的建议内容 |
∟anticheat | Object | 是 | 反作弊检测结果,如有检测需求请联系易盾策略经理开启服务 |
∟ taskId | String | 是 | 检测任务ID |
∟ suggestion | Number | 是 | 建议动作,0:通过,1:嫌疑,2:不通过 |
∟ hitInfo | Number | 是 | 命中信息 |
∟ hitType | Number | 是 | 反作弊命中类型,详见hitType返回码及含义表 |
人工审核结果
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
result | Object[] | 是 | 网站人工审核结果 |
∟ censor | Object | 是 | 网站人工审核结果,接入人工审核后,才会返回此信息 |
∟ taskId | String | 是 | 本次请求数据标识,可以根据该标识查询数据最新结果 |
∟ dataId | String | 否 | 数据唯一标识,能够根据该值定位到该条数据,如对数据结果有异议,可以发送该值给策略经理查询 |
∟ callback | String | 否 | 数据回调参数,请求参数中传来的callback字段原样返回 |
∟ url | String | 否 | 网页URL(指定主站域名下具体的网页URL) |
∟ siteUrl | String | 否 | 主站URL |
∟ siteName | String | 否 | 网站名 |
∟ suggestion | Number | 是 | 建议动作,0:通过,1:嫌疑,2:不通过 |
∟ resultType | Number | 是 | 结果类型,1:机器结果,2:人审结果 |
∟ censorTime | Number | 是 | 审核时间,毫秒单位的时间戳 |
∟ censorSource | Number | 是 | 审核来源,0:易盾人审,1:客户审核,2:易盾机审,3:用户质检,4:易盾质检 |
∟ censor | String | 是 | 审核操作人 |
∟ snapshotUrl | String | 否 | 网页快照链接 |
∟ censorLabels | Object[] | 否 | 审核标签信息 |
∟ code | String | 是 | 审核标签标签唯一编号 |
∟ name | String | 是 | 审核标签的名称 |
∟ customCode | 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 | 否 | 选择标签填写的备注内容 |
∟ audios | Object[] | 否 | 音频证据信息 |
∟ reasons | Object[] | 否 | 判定原因 |
∟ url | String | 否 | 人审标注的音频url |
∟ reason | String | 否 | 判定原因 |
∟ censorLabels | Object[] | 否 | 审核标签信息 |
∟ code | String | 是 | 审核标签标签唯一编号 |
∟ name | String | 是 | 审核标签的名称 |
∟ desc | String | 否 | 选择标签填写的备注内容 |
∟ startTime | Number | 否 | 标注开始时间点对应的毫秒时间戳 |
∟ endTime | Number | 否 | 标注结束时间点对应的毫秒时间戳 |
∟ audiovideos | Object[] | 否 | 视频证据信息 |
∟ audios | Object[] | 否 | 视频中音频的判定原因 |
∟ url | String | 否 | 人审标注的音频url |
∟ reason | String | 否 | 判定原因 |
∟ startTime | Number | 否 | 标注开始时间点对应的毫秒时间戳 |
∟ endTime | Number | 否 | 标注结束时间点对应的毫秒时间戳 |
∟ censorLabels | Object[] | 否 | 审核标签信息 |
∟ code | String | 是 | 审核标签标签唯一编号 |
∟ name | String | 是 | 审核标签的名称 |
∟ desc | String | 否 | 选择标签填写的备注内容 |
∟ videos | Object[] | 否 | 视频的判定原因 |
∟ url | String | 否 | 人审标注的视频url |
∟ reason | String | 否 | 判定原因 |
∟ startTime | Number | 否 | 标注开始时间点对应的毫秒时间戳 |
∟ endTime | Number | 否 | 标注结束时间点对应的毫秒时间戳 |
∟ censorLabels | Object[] | 否 | 审核标签信息 |
∟ code | String | 是 | 审核标签标签唯一编号 |
∟ name | String | 是 | 审核标签的名称 |
∟ desc | String | 否 | 选择标签填写的备注内容 |
∟ files | Object[] | 否 | 文档证据信息 |
∟ texts | Object[] | 否 | 文档中文本判定原因 |
∟ text | String | 否 | 人审标注文本 |
∟ reason | String | 否 | 文本判定原因 |
∟ censorLabels | Object[] | 否 | 审核标签信息 |
∟ code | String | 是 | 审核标签标签唯一编号 |
∟ name | String | 是 | 审核标签的名称 |
∟ desc | String | 否 | 选择标签填写的备注内容 |
∟ images | Object[] | 否 | 文档中图片判定原因 |
∟ url | String | 否 | 人审标注图片url |
∟ reason | String | 否 | 图片判定原因 |
∟ censorLabels | Object[] | 否 | 审核标签信息 |
∟ code | String | 是 | 审核标签标签唯一编号 |
∟ name | String | 是 | 审核标签的名称 |
∟ desc | String | 否 | 选择标签填写的备注内容 |
响应示例
异步检测结果响应示例
{
"code": 200,
"msg": "ok",
"result": [
{
"antispam": {
"checkStatus": 2,
"dataId": "123",
"url":"主站域名下子url",
"siteUrl":"主站url",
"siteName":"网站名",
"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"
}
}
]
}
人工审核结果响应示例
{
"code": 200,
"msg": "ok",
"result": [
{
"censor": {
"dataId": "1636374310837",
"taskId": "9208ba146279470c90aba8cf9b7128a6",
"url":"主站域名下子url",
"siteUrl":"主站url",
"siteName":"网站名",
"suggestion": 2,
"resultType": 2,
"censorSource": 0,
"censorTime": 1636374466354,
"snapshotUrl":"网页快照链接地址",
"censorLabels": [
{
"code": "1600762076926",
"name": "地球",
"customCode": "1",
"desc": ""
},
{
"code": "1600759147543",
"name": "变形金刚",
"customCode": "2",
"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"
}
]
}
]
}
}
}
}
]
}
响应返回码
响应返回码见:响应返回码
示例代码
服务端 SDK 接入
推荐使用我们提供的服务端 SDK 进行接入(目前支持 Java 和 Go 两种语言),不但可以节省接入成本,实现更快速的集成,并享有灵活的请求配置选项,同时 SDK 内置了错误重试、熔断降级等功能,提升服务可用性。点击 服务端 SDK 接入指引 了解更多。