轮询模式

2024.09.02 17:59:14

    获取网站、微信公众号文章、微博主贴检测离线检测结果,客户可以通过轮询调用该接口获取数据。轮询模式与推送模式互斥,只能选取一种模式进行结果获取。

    接口说明

    该接口返回网站、微信公众号文章、微博主贴检测离线检测结果,需要客户通过该接口进行定时轮询获取,当提交检测接口参数 callbackUrl 为空时,表示结果通过该接口获取,结果可以根据提交检测时返回的 taskId 对应。

    鉴权说明

    易盾内容安全服务使用签名方法对接口进行鉴权,所有接口每一次请求都需要包含签名信息(signature 参数),以验证用户身份,防止信息被恶意篡改。目前支持 MD5、SHA1、SHA256、SM3 几种加密算法,详细信息,请参见接口鉴权

    结果说明

    • 获取结果后,下次调用,不会再次返回之前获取过的结果
    • 接口一次最多返回50个结果,结果数据默认保留7天,7天不获取会失效
    • 接口请求频率应小于1s/10次,过快服务器会拒绝处理,客户可以根据业务需求进行适当调整

    接口耗时

    结果获取接口的响应很快,正常50ms内返回结果,业务方根据需求适当调整超时时间,建议为1s

    历史版本

    v2版本网站检测解决方案-单url获取检测结果轮询模式

    请求

    请求地址

    名称
    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 接入指引 了解更多。

    Github Demo 地址

    Gitee Demo 地址(Github 无法访问时选择)

    HTTP API 接入

    Github Demo 地址

    Gitee Demo 地址(Github 无法访问时选择)

    Online Chat Tel:95163223 Free trial