轮询模式

2022.06.24 10:47:31

    数字阅读结果获取的轮询模式用于获取数字阅读异步检测结果或人工审核结果,客户可以通过轮询调用该接口获取数据。轮询模式与推送模式互斥,只能选取一种模式进行结果获取。

    接口说明

    该接口返回数字阅读异步检测结果或人工审核结果,需要客户通过该接口进行定时轮询获取,当提交检测接口参数callbackUrl为空时,表示结果通过该接口获取,结果可以根据提交检测时返回的taskId对应。

    鉴权说明

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

    结果说明

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

    接口耗时

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

    历史版本

    v1版本数字阅读解决方案获取检测结果轮询模式请点此查看

    请求

    请求地址

    名称
    HTTP URL https://as.dun.163.com/v2/digital/callback/results
    HTTP Method POST

    请求头

    名称 类型 必填 描述
    Content-Type String Y 固定值:"application/x-www-form-urlencoded"

    请求参数

    请求参数由公共参数和业务参数两部分组成,公共参数见请求公共参数

    名称 类型 必填 最大长度 描述
    version String Y 4 接口版本,当前版本为v2

    请求体示例

    version=v2&signature=xxx&secretId=xxx
    

    响应

    该接口返回数字阅读异步检测结果或人工审核结果,两类结果响应字段有一定区分。为了方便阅读,下面响应结果分为:异步检测结果和人工审核结果 响应字段如下,响应通用字段已省略,详细见 响应公共字段

    异步检测结果

    名称 类型 必填 描述
    result Object[] 数字阅读机器审核结果
     ∟antispam Object 数字阅读机器检测结果
      ∟taskId String 本次请求数据标识,可以根据该标识查询数据最新结果
      ∟dataId String 数据唯一标识,能够根据该值定位到该条数据,如对数据结果有异议,可以发送该值给客户经理查询
      ∟callback String 数据回调参数,请求参数中传来的callback字段原样返回
      ∟suggestion Number 建议动作,0:通过,1:嫌疑,2:不通过
      ∟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,分类信息,100:色情,200:广告,260:广告法,300:暴恐,400:违禁,500:涉政,600:谩骂,700:灌水,900:其他,1100:涉价值观
         ∟ level Number 命中级别,示例值:1
         ∟ subLabels Object[] 细分类信息,可能包含多个
          ∟ subLabel Number 细分类,详细编码请参考下方对应细分类编码对照表
          ∟ 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[] 图片检测结果
        ∟ dataId String 检测子数据数据唯一标识
        ∟ field String 数据来源字段名。当数据来自提交接口的 content 时,此字段值为 content,当数据来自提交接口自定义字段时,此字段值为自定义字段名
        ∟ name String 图片名称(或图片标识)
        ∟ status Number 检测状态:2 检测成功、3 检测失败
        ∟ failureReason Number 检测失败原因,当status为3(检测失败)时返回:610 图片下载失败、620 图片格式错误、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 分类级别,0:正常,1:不确定,2:确定
         ∟ rate Number 置信度分数,0-1之间取值,1为置信度最高,0为置信度最低。若level为正常,置信度越大,说明正常的可能性越高。若level为不确定或确定,置信度越大,说明垃圾的可能性越高
         ∟ subLabels Object[] 细分类信息,可能包含多个
          ∟ subLabel Number 细分类,详细编码请参考下方对应细分类编码对照表
          ∟ 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[] 音频检测结果
        ∟ 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[] 视频检测结果
        ∟ 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 Number 细分类,详细编码请参考下方对应细分类编码对照表
             ∟ 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[] 文档检测结果
        ∟ 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,分类信息,100:色情,200:广告,260:广告法,300:暴恐,400:违禁,500:涉政,600:谩骂,700:灌水,900:其他,1100:涉价值观
           ∟ level Nunber 命中级别,示例值:1
           ∟ subLabels Object[] 细分类信息,可能包含多个,具体数据结构如下
            ∟ subLabel Number 细分类,详细编码请参考下方对应细分类编码对照表
             ∟ 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 Number 细分类,细分类编码对照表
            ∟ 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 该图片中包含的人脸个数
         ∟ faceContents Object[] 人脸详细信息
          ∟ name String 人脸名字,不可识别则为空
          ∟ gender String 人脸性别,值为男(male)、女(female);不可识别则为空
          ∟ age Integer 人脸年龄,值为具体年龄(age);不可识别则为空
          ∟ type String 人脸类型,包含卡通脸(cartoon)、普通(normal)
          ∟ category String 人物分类,包含名人(star)、普通(normal)
          ∟ beautyScore Number 人脸颜值分数,保留4位小数
          ∟ 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 通用识别
     ∟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字段原样返回
      ∟ suggestion Number 建议动作,0:通过,1:嫌疑,2:不通过
      ∟ resultType Number 结果类型,1:机器结果,2:人审结果
      ∟ censorRound Number 审核轮数,普通审核审核轮数为0,高级审核:1-第1轮人审,2-第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[] 文本证据信息
         ∟ dataId String 检测子数据唯一标识
         ∟ field String 数据来源字段名
         ∟ censorResult Number 字段审核模式下的人工审核结果,0:未审核 1:正常 2:异常
         ∟ reviseContent String 修订后的文本内容
         ∟ reasons Object[] 文本判定原因
          ∟ text String 人审标注文本
          ∟ reason String 文本判定原因
          ∟ censorLabels Object[] 审核标签信息
           ∟ code String 审核标签标签唯一编号
           ∟ name String 审核标签的名称
           ∟ desc String 选择标签填写的备注内容
        ∟ images Object[] 图片证据信息
         ∟ dataId String 检测子数据唯一标识
         ∟ field String 数据来源字段名
         ∟ censorResult Number 字段审核模式下的人工审核结果,0:未审核 1:正常 2:异常
         ∟ reasons Object[] 图片判定原因
          ∟ url String 人审标注图片url
          ∟ reason String 图片判定原因
          ∟ censorLabels Object[] 审核标签信息
           ∟ code String 审核标签标签唯一编号
           ∟ name String 审核标签的名称
           ∟ desc String 选择标签填写的备注内容
        ∟ audios Object[] 音频证据信息
         ∟ dataId String 检测子数据唯一标识
         ∟ field String 数据来源字段名
         ∟ censorResult Number 字段审核模式下的人工审核结果,0:未审核 1:正常 2:异常
         ∟ reasons Object[] 判定原因
          ∟ url String 人审标注的音频url
          ∟ reason String 判定原因
          ∟ censorLabels Object[] 审核标签信息
           ∟ code String 审核标签标签唯一编号
           ∟ name String 审核标签的名称
           ∟ desc String 选择标签填写的备注内容
          ∟ startTime Number 标注开始时间点对应的毫秒时间戳
          ∟ endTime Number 标注结束时间点对应的毫秒时间戳
        ∟ audiovideos Object[] 视频证据信息
         ∟ dataId String 检测子数据唯一标识
         ∟ field String 数据来源字段名
         ∟ censorResult Number 字段审核模式下的人工审核结果,0:未审核 1:正常 2:异常
         ∟ 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[] 文档证据信息
         ∟ dataId String 检测子数据唯一标识
         ∟ field String 数据来源字段名
         ∟ censorResult Number 字段审核模式下的人工审核结果,0:未审核 1:正常 2:异常
         ∟ 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",
                    "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.0,
                                                "details": {
                                                    "hitInfos": [
                                                        {
                                                            "y1": 0.1756,
                                                            "y2": 0.7165,
                                                            "x1": 0.1711,
                                                            "x2": 0.8457,
                                                            "value": "李四"
                                                        }
                                                    ]
                                                }
                                            }
                                        ],
                                        "level": 2,
                                        "rate": 1.0,
                                        "label": 500
                                    },
                                    {
                                        "level": 0,
                                        "rate": 1.0,
                                        "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
                            }
                        ],
                        "files": [
                            {
                                "dataId": "468214",
                                "field": "content",
                                "resultType": 1,
                                "suggestion": 2,
                                "evidences": {
                                    "texts": [
                                        {
                                            "sequence": 0,
                                            "startText": "dadfa",
                                            "endText": "ng wu ma ",
                                            "suggestion": 2,
                                            "labels": [
                                                {
                                                    "label": 500,
                                                    "level": 2,
                                                    "subLabels": [
                                                        {
                                                            "subLabel": "500013",
                                                            "details": {
                                                                "hitInfos": [
                                                                    {
                                                                        "value": "文本",
                                                                        "positions": [
                                                                            {
                                                                                "fieldName": "content",
                                                                                "startPos": 386,
                                                                                "endPos": 389
                                                                            }
                                                                        ]
                                                                    }
                                                                ]
                                                            }
                                                        }
                                                    ]
                                                }
                                            ],
                                            "page": 1
                                        }
                                    ],
                                    "images": [
                                        {
                                            "sequence": 0,
                                            "imageUrl": "http://12.png",
                                            "suggestion": 0,
                                            "labels": [
                                                {
                                                    "label": 500,
                                                    "level": 0,
                                                    "rate": 1.0
                                                }
                                            ],
                                            "page": 2
                                        }
                                    ]
                                }
                            }
                        ]
                    },
                    "resultType": 1,
                    "taskId": "mp84l9cwy8eqfxydqnx53vug05009pgw"
                },
                "valueAddService": {
                    "emotionAnalysis": {
                        "texts": [
                            {
                                "dataId": "192470",
                                "field": "image1",
                                "details": [
                                    {
                                        "sentiment": "positive",
                                        "positiveProb": 0.7576994299888611,
                                        "negativeProb": 0.24208970367908478
                                    }
                                ],
                                "taskId": "81uoe1igu601b2v2wfoik3fg05009pgr"
                            }
                        ]
                    },
                    "face": {
                        "images": [
                            {
                                "dataId": "792707",
                                "field": "image1",
                                "details": [
                                    {
                                        "faceContents": [
                                            {
                                                "maskType": "normal",
                                                "expression": "happy",
                                                "gender": "male",
                                                "y1": 0.1756,
                                                "name": "张三",
                                                "y2": 0.7165,
                                                "x1": 0.1711,
                                                "x2": 0.8457,
                                                "type": "normal",
                                                "category": "normal",
                                                "beautyScore": 0.49,
                                                "age": 50
                                            }
                                        ],
                                        "faceNumber": 1
                                    }
                                ],
                                "taskId": "81uoe1igu601b2v2wfoik3fg05009pgr"
                            }
                        ]
                    },
                    "imageDiscern": {
                        "images": [
                            {
                                "dataId": "792707",
                                "field": "image1",
                                "details": [
                                    {
                                        "rate": 0.9593,
                                        "type": 3,
                                        "discernName": "张三"
                                    },
                                    {
                                        "rate": 0.755,
                                        "type": 3,
                                        "discernName": "人物特写"
                                    },
                                    {
                                        "rate": 0.4752,
                                        "type": 3,
                                        "discernName": "人脸"
                                    }
                                ],
                                "taskId": "81uoe1igu601b2v2wfoik3fg05009pgr"
                            }
                        ]
                    },
                    "logo": {
                        "images": [
                            {
                                "dataId": "792707",
                                "field": "image1",
                                "details": [
                                    
                                ],
                                "taskId": "81uoe1igu601b2v2wfoik3fg05009pgr"
                            }
                        ]
                    },
                    "language": {
                        "texts": [
                            {
                                "dataId": "192470",
                                "field": "image1",
                                "details": [
                                    {
                                        "type": "zh"
                                    }
                                ],
                                "taskId": "81uoe1igu601b2v2wfoik3fg05009pgr"
                            }
                        ]
                    },
                    "imageQuality": {
                        "images": [
                            {
                                "dataId": "792707",
                                "field": "image1",
                                "details": [
                                    {
                                        "metaInfo": {
                                            "byteSize": 124343,
                                            "format": "png",
                                            "width": 267,
                                            "height": 333
                                        },
                                        "sharpnessRate": 0.7394,
                                        "aestheticsRate": 0.6262,
                                        "boarderInfo": {
                                            "hit": false,
                                            "top": false,
                                            "left": false,
                                            "bottom": false,
                                            "right": false
                                        },
                                        "backgroundInfo": {
                                            "pureBackground": false
                                        }
                                    }
                                ],
                                "taskId": "81uoe1igu601b2v2wfoik3fg05009pgr"
                            }
                        ]
                    },
                    "ocr": {
                        "images": [
                            {
                                "dataId": "792707",
                                "field": "image1",
                                "width": 267,
                                "details": [
                                    
                                ],
                                "taskId": "81uoe1igu601b2v2wfoik3fg05009pgr",
                                "height": 333
                            }
                        ]
                    }
                },
                "anticheat": {
                    "suggestion": 2,
                    "taskId": "81uoe1igu601b2v2wfoik3fg05009pgr",
                    "hitInfo": {
                        "hitType": 3
                    }
                }
            }
        ]
    }
    

    人工审核结果响应示例

    {
        "code": 200,
        "msg": "ok",
        "result": [
            {
                "censor": {
                    "censorLabels": [
                        {
                            "code": "1600759147543",
                            "name": "变形金刚",
                            "desc": "变形金刚/地球"
                        },
                        {
                            "code": "1600762076926",
                            "name": "地球",
                            "desc": ""
                        }
                    ],
                    "suggestion": 2,
                    "censorRound": 0,
                    "censorTime": 1630549946549,
                    "reviewEvidences": {
                        "reason": "其他",
                        "remark": "",
                        "detail": {
                            "images": [
                                {
                                    "censorResult": 0,
                                    "reasons": [
                                        {
                                            "censorLabels": [
                                                
                                            ],
                                            "reason": "违规图片",
                                            "url": "https://image.jpg"
                                        }
                                    ],
                                    "dataId": "809577",
                                    "field": "content"
                                }
                            ],
                            "texts": [
                                {
                                    "censorResult": 2,
                                    "reasons": [
                                        {
                                            "censorLabels": [
                                                
                                            ],
                                            "reason": "违规文本",
                                            "text": "异常的的异常"
                                        }
                                    ],
                                    "dataId": "427331",
                                    "field": "content"
                                },
                                {
                                    "censorResult": 1,
                                    "dataId": "8114",
                                    "field": "content"
                                }
                            ],
                            "audios": [
                                {
                                    "censorResult": 2,
                                    "dataId": "855180",
                                    "field": "content",
                                    "reasons": [
                                        {
                                            "censorLabels": [
                                                
                                            ],
                                            "reason": "音频违规",
                                            "startTime": 0,
                                            "endTime": 0,
                                            "url": "https://audio.mp3"
                                        }
                                    ]
                                }
                            ],
                            "files": [
                                {
                                    "censorResult": 2,
                                    "dataId": "855180",
                                    "field": "content",
                                    "texts": [
                                        {
                                            "censorLabels": [
                                                
                                            ],
                                            "reason": "违规文本",
                                            "text": "异常的的异常"
                                        }
                                    ],
                                    "images": [
                                        {
                                            "censorLabels": [
                                                
                                            ],
                                            "reason": "违规图片",
                                            "url": "https://image.jpg"
                                        }
                                    ]
                                }
                            ],
                            "videos": [
                                {
                                    "censorResult": 2,
                                    "dataId": "855180",
                                    "field": "content",
                                    "reasons": [
                                        {
                                            "censorLabels": [
                                                
                                            ],
                                            "reason": "视频中图片违规",
                                            "startTime": 0,
                                            "endTime": 0,
                                            "url": "https://video.mp4"
                                        }
                                    ]
                                }
                            ],
                            "audiovideos": [
                                {
                                    "censorResult": 2,
                                    "dataId": "855180",
                                    "field": "content",
                                    "audios": [
                                        {
                                            "censorLabels": [
                                                
                                            ],
                                            "reason": "音频违规",
                                            "startTime": 0,
                                            "endTime": 0,
                                            "url": "https://video.mp4"
                                        }
                                    ],
                                    "videos": [
                                        {
                                            "censorLabels": [
                                                
                                            ],
                                            "reason": "视频中图片违规",
                                            "startTime": 0,
                                            "endTime": 0,
                                            "url": "https://video.mp4"
                                        }
                                    ]
                                }
                            ]
                        }
                    },
                    "skipCensor": 0,
                    "censorSource": 0,
                    "resultType": 2,
                    "taskId": "x4vo2xy2whrd3ovnsb7dplhg05009phe"
                }
            }
        ]
    }
    

    SDK接入方法

    为方便 JAVA 开发者调试和接入API,我们提供了配套的开发工具集(SDK),用于简化API接入流程。SDK中各接口调用方式基本相同,接入方式统一,并提供了一些接口调用过程中常见的异常处理方案。以下介绍了SDK的使用流程,以及首次使用SDK的简单示例。

    如果您使用的是其他语言,请参考各语言示例demo

    • 准备工作

    准备步骤详见通用步骤

    • 使用方法

    使用方法可参考使用SDK

    Online Chat Tel:95163223