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

接口说明

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

鉴权说明

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

结果说明

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

接口耗时

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

历史版本

v1版本文档解决方案结果获取轮询模式请点此查看

请求

请求地址

请求头

请求参数

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

公共参数

公共参数包含密钥信息和参数签名信息，公共参数详细见请求公共参数

业务参数

请求体示例

version=v2&signature=xxx&secretId=xxx&nonce=xxxx&timrstamp=1659673551000

响应

该接口可以返回人工审核结果或异步机器检测结果，两类结果响应字段有一定区分，可根据resultType字段进行区分解析，为了方便阅读，下面响应结果分为：人工审核响应结果以及异步检测相应结果

异步检测结果

响应字段如下，响应公共字段已省略，详细见响应公共字段，resultType为1时表示机器检测结果，详细字段信息如下：

人工审核响应结果

响应字段如下，响应公共字段已省略，详细见响应公共字段，resultType为2时表示人工审核结果，详细字段信息如下：

响应示例

异步检测结果响应示例

{
    "code": 200,
    "msg": "ok",
    "result": [
        {
            "antispam": {
                "dataId": "1631624661543",
                "taskId": "9183116cf3e6445aa1fe62596689785d",
                "resultType": 1,
                "suggestion": 0,
                "evidences": {
                    "texts": [
                        {
                            "taskId": "80594e188cb1476faf7e9af0d5674cea",
                            "sequence": 0,
                            "startText": "哈哈",
                            "endText": "嗯嗯",
                            "suggestion": 0,
                            "labels": [],
                            "page": 2
                        },
                        {
                            "taskId": "658b05b4d17b49b9a68bead9780cd80a",
                            "sequence": 1,
                            "startText": "n",
                            "endText": "n",
                            "suggestion": 0,
                            "labels": [
                                {
                                    "label": 500,
                                    "level": 2,
                                    "subLabels": [
                                        {
                                            "subLabel": "500013",
                                            "details": {
                                                "hitInfos": [
                                                    {
                                                        "positions": [
                                                            {
                                                                "fieldName": "content",
                                                                "startPos": 388,
                                                                "endPos": 391
                                                            }
                                                        ],
                                                        "value": "xxx"
                                                    }
                                                ]
                                            }
                                        }
                                    ]
                                }
                            ],
                            "page": 3
                        }
                    ],
                    "images": [
                        {
                            "taskId": "57a2ecf017b94f4592b5f82659e40e0b",
                            "sequence": 0,
                            "imageUrl": "https://iamge-url",
                            "suggestion": 0,
                            "labels": [
                                {
                                    "label": 500,
                                    "level": 0,
                                    "rate": 1.0
                                },
                                {
                                    "label": 300,
                                    "level": 0,
                                    "rate": 1.0,
                                    "labels": [
                                        {
                                            "label": 400,
                                            "level": 1,
                                            "rate": 0.9804,
                                            "subLabels": [
                                                {
                                                    "subLabel": "40009",
                                                    "rate": 0.9643,
                                                    "details": {
                                                        "hitInfos": [
                                                            {
                                                                "value": "fire",
                                                                "group": "违禁"
                                                            }
                                                        ]
                                                    }
                                                },
                                                {
                                                    "subLabel": "40010",
                                                    "rate": 0.9964,
                                                    "details": {
                                                        "hitInfos": [
                                                            {
                                                                "value": "skull",
                                                                "group": "违禁"
                                                            }
                                                        ]
                                                    }
                                                }
                                            ]
                                        }
                                    ]
                                },
                                {
                                    "label": 100,
                                    "level": 0,
                                    "rate": 0.9999
                                },
                                {
                                    "label": 400,
                                    "level": 0,
                                    "rate": 1.0
                                },
                                {
                                    "label": 200,
                                    "level": 0,
                                    "rate": 1.0
                                }
                            ],
                            "page": 3
                        }
                    ]
                }
            }
        }
    ]
}

人工审核结果响应示例

{
    "code":200,
    "msg":"ok",
    "result":[
        {
            "antispam":{
                "dataId":"1631625592988",
                "taskId":"a20f4815fb624f0ba9b02463f5715cb9",
                "reviewEvidences":{
                    "remark":"",
                    "detail":{
                        "text":[
                            {
                                "text":"xxxx",
                                "reason":"好"
                            }
                        ],
                        "image":[
                            {
                                "url":"https://immage-url",
                                "reason":"图片标注"
                            }
                        ]
                    }
                },
                "censorLabels":[
                    {
                        "code":"1600762076926",
                        "customCode":"自定义标签编码",
                        "name":"审核标签名称",
                        "desc":""
                    },
                    {
                        "code":"1600759147543",
                        "customCode":"自定义标签编码",
                        "name":"审核标签名称",
                        "desc":""
                    }
                ],
                "censorTime":1631625622490,
                "resultType":2,
                "censorSource":1,
                "censorRound":0,
                "suggestion":0,
                "evidences":{

                }
            }
        }
    ]
}

接入示例代码

开发工具集（SDK）接入

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

• 准备工作

准备步骤详见通用步骤

• 使用方法

该接口的使用方法可参考SDK demo

API接入

如果您选择非SDK接入，使用API方式接入，请参考各开发语言汇总示例代码

该接口的使用方法具体示例如下：

PHP示例代码
Python示例代码
go示例代码
Nodejs示例代码
C#示例代码
JAVA示例代码