帮助中心

数字阅读解决方案回调查询接口

2021.09.28 14:13:37

接口地址

https://as.dun.163.com/v1/digital/callback/query

接口描述

接口功能，在离线接口获取数据结果之后避免网络原因等数据丢失，可以在数字阅读解决方案查询接口获取数据，查询时限为30天内数据，建议您使用POST请求, 且仅接受 application/x-www-form-urlencoded 编码格式。

接口请求频率

单次调用支持查询最多100条数据，QPS限制1s最多查询100个taskid。

请求参数

请求公共参数详细见请求公共参数

参数名称	类型	是否必选	最大长度	描述
version	String	Y	4	接口版本，当前版本为 v1.1
taskIds	json数组	Y	4	单次查询支持最多查询100条数据

响应结果

响应字段如下，响应通用字段已省略，详细见响应通用字段：

result 数据结构

参数名称	类型	描述
antispam	json对象	内容安全检测结果
anticheat	json对象	反作弊检测结果

antispam 数据结构

参数名称	类型	描述
taskId	String	数据请求标识，可以根据该标识查询融媒体数据最新结果
dataId	String	调用融媒体检测时传递的dataId字段
callback	String	调用检测时传递的callback字段
checkStatus	Number	检测状态, 1:检测中 2:检测成功 3:检测失败
result	Number	检测结果, 0:无结果（检测失败）1:正常 2:异常 3：疑似
resultType	Number	审核类型，1:机器检测，2:审核
censorSource	Number	审核来源,0:易盾人审，1:用户人审，2:易盾机审
censorRound	Number	审核轮数，1：第1轮人审，2：第2轮人审，3：第3轮人审，4：第4轮人审，5：第5轮人审，未设置审核模式默认返回0
censorLabels	json数组	支持在智能审核系统自定义标签分类信息
evidences	json对象	机审证据信息
reviewEvidences	json对象	人审证据信息，接入人工审核后，参考人审证据信息

censorLabels 数据结构

参数名称	类型	描述
code	String	在智能审核系统配置自定义标签之后会生成一个唯一的标签编号
desc	String	在智能审核系统配置自定义标签备注
customCode	String	自定义的标签code

evidences 数据结构

参数名称	类型	描述
texts	json数组	文本证据信息
images	json数组	图片证据信息
audios	json数组	语音证据信息
videos	json数组	视频证据信息
audiovideos	json数组	语音视频证据信息
files	json数组	文档证据信息

texts 数据结构

参数名称	类型	描述
dataId	String	提交检测时标识的数据id
action	Number	检测结果，0：通过，1：嫌疑，2：不通过
labels	json数组	分类信息详细数据与文本在线检测labels数据结构一致
field	String	数据来源字段名。当数据来自提交接口的 title 或 content 时，此字段值为 title 或 content，当数据来自提交接口扩展字段时，此字段值为扩展字段名

labels 数据结构

参数名称	类型	描述
label	Number	分类信息，100：色情，200：广告，260：广告法，300：暴恐，400：违禁，500：涉政，600：谩骂，700：灌水，900：其他
level	Number	分类级别，0：通过， 1：嫌疑，2：不通过
details	json对象	其他信息

details 数据结构

参数名称	类型	描述
hint	json数组	线索信息，用于定位文本中有问题的部分，辅助人工审核

images 数据结构

参数名称	类型	描述
name	String	图片标识
dataId	String	提交检测时标识的数据id
status	Number	图片检测状态码，定义为：0：检测成功，610：图片下载失败，620：图片格式错误，630：其它
action	Number	检测结果，0：通过，1：嫌疑，2：不通过
labels	json数组	分类信息
field	String	数据来源字段名。当数据来自提交接口的 title 或 content 时，此字段值为 title 或 content，当数据来自提交接口扩展字段时，此字段值为扩展字段名

labels 数据结构

参数名称	类型	描述
label	Number	分类信息，100：色情，110：性感低俗，200：广告，210：二维码，260：广告法，300：暴恐，400：违禁，500：涉政，900：其他
level	Number	分类级别，0：通过，1：嫌疑，2：不通过
rate	Number	置信度分数，0-1之间取值，1为置信度最高，0为置信度最低。若level为正常，置信度越大，说明正常的可能性越高。若level为不确定或确定，置信度越大，说明垃圾的可能性越高

audios 数据结构

参数名称	类型	描述
dataId	String	提交检测时标识的数据id
asrStatus	Number	音频翻译结果，2：检测中，3：检测完成，4：检测失败
asrResult	Number	音频翻译检测失败原因，1：文件格式错误，2：文件下载失败，3：解析失败，4：音频流不存在
action	Number	检测结果，0：通过，1：嫌疑，2：不通过
labels	json数组	分类信息
field	String	数据来源字段名。当数据来自提交接口的 title 或 content 时，此字段值为 title 或 content，当数据来自提交接口扩展字段时，此字段值为扩展字段名

labels 数据结构

参数名称	类型	描述
label	Number	分类信息，100：色情，200：广告，260：广告法，300：暴恐，400：违禁，500：涉政，600：谩骂
level	Number	分类级别，0：通过，1：嫌疑，2：不通过
details	json对象	其他信息

details 数据结构

参数名称	类型	描述
hint	Number	线索信息，用于定位文本中有问题的部分，辅助人工审核
hitType	Number	命中检测器类型：10：用户名单 11:IP名单 12:设备名单 30:敏感词 110:IP地区限制 130:声纹检测

hint 数据结构

参数名称	类型	描述
value	String	命中的敏感词或者声纹检测的分值
segments	json数组	命中敏感词或者声纹检测的音频时间点

segments 数据结构

参数名称	类型	描述
startTime	Number	最近开始时间点，单位毫秒
endTime	Number	最近结束时间点，单位毫秒

videos 数据结构

参数名称	类型	描述
dataId	String	提交检测时标识的数据id
status	Number	视频处理状态码，定义为：0：检测成功，110：请求重复，120：参数错误，130：解析错误，140：数据类型错误
level	Number	视频级别信息，分为0:正常，1：不确定，2：确定，其中不确定的建议人工复审
evidences	json对象数组	证据信息数组
field	String	数据来源字段名。当数据来自提交接口的 title 或 content 时，此字段值为 title 或 content，当数据来自提交接口扩展字段时，此字段值为扩展字段名

evidences 数据结构

参数名称	类型	描述
beginTime	Number	证据开始相对时间，单位为毫秒，调用方获取后可自行格式化为可视化时间，如：149000 转换为"00:02:29"
endTime	Number	证据结束相对时间，单位为毫秒，调用方获取后可自行格式化为可视化时间，如：149000 转换为"00:02:29"
type	Number	1：图片，2：视频
url	String	证据信息
labels	json对象数组	证据结果数组

labels 数据结构

参数名称	类型	描述
label	Number	分类信息，100：色情，110：性感；200：广告，210：二维码，260：广告法，300：暴恐，400：违禁，500：涉政，1020：黑屏，1030：挂机
level	Number	级别信息，分为1：不确定，2：确定
rate	Number	分数

audiovideos 数据结构

参数名称	类型	描述
dataId	String	提交检测时标识的数据id
result	Number	检测结果 0:无结果（检测失败）, 1:正常 2:异常 3:嫌疑
evidences	json对象	证据信息数组
field	String	数据来源字段名。当数据来自提交接口的 title 或 content 时，此字段值为 title 或 content，当数据来自提交接口扩展字段时，此字段值为扩展字段名

evidences 数据结构

参数名称	类型	描述
audio	json对象	语音证据信息，结构与audios数组元素一致
video	json对象	语音证据信息，结构与videos数组元素一致

files 数据结构

参数名称	类型	描述
dataId	String	提交检测时标识的数据id
result	Number	检测结果 0:无结果（检测失败）, 1:正常 2:异常 3:嫌疑
failureReason	Number	检测失败原因
evidences	json对象	证据信息数组
field	String	数据来源字段名。当数据来自提交接口的 title 或 content 时，此字段值为 title 或 content，当数据来自提交接口扩展字段时，此字段值为扩展字段名

failureReason 说明

错误码	描述
1000	文档大小超过上限
1001	文档格式不支持
1002	文档下载失败
2000	文档内容提取失败
2001	文档内容提取超时
3000	文档检测失败
3001	文档文本检测失败
3002	文档图片检测失败

evidences 数据结构

参数名称	类型	描述
texts	json对象数组	文本证据信息
images	json对象数组	图片证据信息

texts 数据结构

参数名称	类型	描述
taskId	String	当前分段检测数据标识
sequence	Number	当前文本在原始文档中的分段（5000字符/段）序号
startText	String	每段文本的起始20个字符
endText	String	每段文本的结尾20个字符
action	Number	检测结果，0：通过，1：嫌疑，2：不通过
labels	json对象数组	分类信息详细数据与文本在线检测labels数据结构一致

images 数据结构

参数名称	类型	描述
taskId	String	当前图片检测数据标识
sequence	Number	当前图片在原始文档中的序号
imageUrl	String	图片下载地址
level	Number	分类级别，0：正常，1：不确定，2：确定
labels	json对象数组	分类信息详细数据与图片在线检测labels数据结构一致

reviewEvidences 数据结构

参数名称	类型	描述
reason	String	判定原因
remark	String	备注信息
detail	json数组	人审证据详细信息

detail 数据结构

参数名称	类型	描述
texts	json数组	文本证据信息
images	json数组	图片证据信息
audios	json数组	语音证据信息
videos	json数组	视频证据信息
audiovideos	json数组	语音视频证据信息
files	json数组	文档证据信息

texts 数据结构

参数名称	类型	描述
dataId	String	提交检测时标识的数据id
field	String	数据来源字段名。当数据来自提交接口的 title 或 content 时，此字段值为 title 或 content，当数据来自提交接口扩展字段时，此字段值为扩展字段名
reviseContent	String	修订后的文本内容
censorResult	Number	字段审核模式下的人工审核结果，1:正常 2:异常
reasons	TextReason 数组	文本判定原因

TextReason 数据结构

参数名称	类型	描述
text	String	人审标注文本
reason	String	文本判定原因

images 数据结构

参数名称	类型	描述
dataId	String	提交检测时标识的数据id
field	String	数据来源字段名。当数据来自提交接口的 title 或 content 时，此字段值为 title 或 content，当数据来自提交接口扩展字段时，此字段值为扩展字段名
censorResult	Number	字段审核模式下的人工审核结果，1:正常 2:异常
reasons	ImageReason 数组	图片判定原因

ImageReason 数据结构

参数名称	类型	描述
url	String	人审标注图片url
reason	String	图片判定原因

audios 和 videos 数据结构

参数名称	类型	描述
dataId	String	提交检测时标识的数据id
field	String	数据来源字段名。当数据来自提交接口的 title 或 content 时，此字段值为 title 或 content，当数据来自提交接口扩展字段时，此字段值为扩展字段名
censorResult	Number	字段审核模式下的人工审核结果，1:正常 2:异常
reasons	AudioVideoReason 数组	判定原因

audiovideos 数据结构

参数名称	类型	描述
dataId	String	提交检测时标识的数据id
field	String	数据来源字段名。当数据来自提交接口的 title 或 content 时，此字段值为 title 或 content，当数据来自提交接口扩展字段时，此字段值为扩展字段名
censorResult	Number	字段审核模式下的人工审核结果，1:正常 2:异常
videos	AudioVideoReason 数组	视频证据信息
audios	AudioVideoReason 数组	音频证据信息

AudioVideoReason 数据结构

参数名称	类型	描述
url	String	人审标音频或视频url
startTime	Number	标注开始时间点，单位毫秒
endTime	Number	标注结束时间点，单位毫秒
reason	String	判定原因

files 数据结构

参数名称	类型	描述
dataId	String	提交检测时标识的数据id
field	String	数据来源字段名。当数据来自提交接口的 title 或 content 时，此字段值为 title 或 content，当数据来自提交接口扩展字段时，此字段值为扩展字段名
censorResult	Number	字段审核模式下的人工审核结果，1:正常 2:异常
texts	TextReason 数组（见上文）	文本证据信息
images	ImageReason 数组（见上文）	图片证据信息

anticheat 数据结构

参数名称	类型	描述
taskId	String	本次请求数据标识，可以根据该标识查询数据最新结果
action	Number	检测结果，0：通过，10：嫌疑，20：不通过
hitInfo	数组	命中信息，其中hitType类型为int，含义是命中类型，详见 hitType返回码及含义表。

响应示例

查询结果返回如下

{
  "code": 200,
  "msg": "ok",
  "result": [
    {
      "antispam": {
        "taskId": "a56d264d8a4649dfaa5595fa93363a56",
        "dataId": "81016504",
        "callback": "xxx",
        "result": 2,
        "checkStatus": 2,
        "resultType": 1,
        "censorSource": 2,
        "evidences": {
          "texts": [
            {"action":2,"dataId":"xxx","labels":[{"label":200,"level":2,"details":{"hint":[]}}],"field":"title"},
            {"action":2,"dataId":"xxx","labels":[{"label":200,"level":2,"details":{"hint":[]}}],"field":"content"}
          ],
          "images": [
            {"name":"xxx","dataId":"xxx","status":0,"action":2,"labels":[{"label":100,"level":2,"rate":1.0}],"field":"content"}
          ],
          "audios": [
            {
              "action":2,
              "asrStatus":3,
              "asrResult":0,
              "dataId":"bad-audio",
              "labels":[{"label":500,"level":2,"details":{"hint":[{"value":"为何渴望回归中国","segments":[{"startTime":0,"endTime":8}]}],"hitType":30}}],
              "field":"content"
            }
          ],
          "videos": [
            {
              "dataId": "bad-video",
              "status": 0,
              "level": 2,
              "evidences": [
                {
                  "type": 1,
                  "url": "https://illegal-video.nosdn.127.net/xxx.jpg",
                  "beginTime": 5000,
                  "endTime": 5000,
                  "labels": [ { "label": 400, "level": 2, "rate": 1.0 } ]
                }
              ],
              "field": "content"
            }
          ],
          "audiovideos": [
            {
              "dataId": "bad-video",
              "result": 2,
              "evidences": {
                "audio": {
                  "action": 0,
                  "asrStatus": 3,
                  "asrResult": 0,
                  "labels": []
                },
                "video": {
                  "status": 0,
                  "level": 2,
                  "evidences": [
                    {
                      "type": 1,
                      "url": "https://illegal-video.nosdn.127.net/36e87656738e4a379b4c15ff7fa8dfdf_1606874137263.jpg",
                      "beginTime": 5000,
                      "endTime": 5000,
                      "labels": [ { "label": 400, "level": 2, "rate": 1.0 } ]
                    }
                  ]
                }
              },
              "field": "content"
            }
          ],
          "files": [
            {
              "dataId": "bad-file",
              "result": 2,
              "evidences": {
                "texts": [
                  {
                    "taskId": "5eb773f887b54c08b433a9498dd20c0d",
                    "sequence": 0,
                    "startText": "\n\n\n\n\n\n\n\n\n\n",
                    "endText": "\n\n\n\n\n\n\n\n\n\n",
                    "action": 0,
                    "labels": [ { "label": 0, "level": 0 } ]
                  }
                ],
                "images": [
                  {
                    "taskId": "59ab4ea3e06442ce965c79d6192ec42a",
                    "sequence": 0,
                    "imageUrl": "https://yidun-antispam.nos-eastchina1.126.net/59ab4ea3e06442ce965c79d6192ec42a?Signature=nxFs3kh%2FgvBricm8mq7j%2BgyeDO2QWsKbxC26s2QdqYg%3D&Expires=1609466135&NOSAccessKeyId=a681ebcbcd5646a488d275c33acb16bd",
                    "level": 1,
                    "labels": [ { "label": 400, "level": 1, "rate": 0.98845863 }
                    ]
                  }
                ]
              },
              "resultType": 1,
              "field": "content"
            }
          ]
        }
      },
      "anticheat": {
        "action": 20,
        "taskId": "a56d264d8a4649dfaa5595fa93363a56",
        "hitInfo": {
          "hitType": 3
        }
      }
    }
  ]
}

当获取人工审核离线结果时，输出示例如下：

{
  "code": 200,
  "msg": "ok",
  "result": [
    {
      "antispam": {
        "taskId": "0c32b124e4bd43c69ed0e832c1ee1cb5",
        "dataId": "242365478655main",
        "callback": "callback",
        "result": 2,
        "checkStatus": 2,
        "resultType": 2,
        "censorSource": 1,
        "censorRound": 1,
        "censorLabels": [
          {
            "code": "在智能系统配置自定义标签之后会生成一个唯一的标签",
            "desc": "备注",
            "customCode":"9000"
          }
        ],
        "reviewEvidences": {
          "reason": "其他",
          "remark": "备注",
          "detail": {
            "texts": [
              {
                "field": "title",
                "dataId": "0c32b124e4bd43c69ed0e832c1ee1cb5",
                "reasons": [
                  {
                    "text": "itle",
                    "reason": "aaa"
                  }
                ]
              },
              {
                "field": "content",
                "dataId": "sample-text"
              }
            ],
            "images": [
              {
                "field": "content",
                "dataId": "sample-image",
                "reasons": [
                  {
                    "url": "https://yidun-antispam.nos-eastchina1.126.net/xxx",
                    "reason": "sss"
                  }
                ]
              }
            ],
            "audios": [
              {
                "field": "content",
                "dataId": "bad-audio",
                "reasons": [
                  {
                    "url": "https://yidun-antispam.nos-eastchina1.126.net/xxx",
                    "startTime": 29,
                    "endTime": 33
                  },
                  {
                    "url": "https://yidun-antispam.nos-eastchina1.126.net/xxx",
                    "startTime": 2,
                    "endTime": 29
                  }
                ]
              }
            ],
            "videos": [
              {
                "field": "content",
                "dataId": "bad-video",
                "reasons": [
                  {
                    "url": "http://illegal-video.nosdn.127.net/xxx",
                    "startTime": 0,
                    "endTime": 0,
                    "reason": "xxx"
                  }
                ]
              }
            ],
            "audiovideos": [
              {
                "field": "content",
                "dataId": "good-video",
                "videos": [
                  { "url": "http://illegal-video.nosdn.127.net/xxx", "startTime": 0, "endTime": 0, "reason": "aaa" },
                  { "url": "http://illegal-video.nosdn.127.net/xxx", "startTime": 0, "endTime": 0, "reason": "bb" }
                ],
                "audios": [
                  { "url": "http://illegal-video.nosdn.127.net/xxx", "startTime": 0, "endTime": 0, "reason": "fdfd" }
                ]
              }
            ],
            "files": [
              {
                "field": "content",
                "dataId": "xxx",
                "texts": [
                  { "text": "想到了", "reason": "a" },
                  { "text": "布的张", "reason": "bb" }
                ],
                "images": [
                  { "url": "https://yidun-antispam.nos-eastchina1.126.net/xxx", "reason": "tt" }
                ]
              }
            ]
          }
        }
      }
    }
  ]
}

当无最新离线结果需要获取时，输出示例如下：

{
    "code": 200,
    "msg": "ok",
    "result":[]
}

上一篇：结果获取接口

对文档做个评价吧：

如果遇到产品相关问题，您可提交工单或在线咨询寻求帮助。

在线咨询电话咨询：95163223 免费试用