内容安全文本异步检测或人工审核的结果，客户可以通过轮询调用该接口获取数据，轮询模式与推送模式互斥，只能选取一种模式进行结果获取

接口说明

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

鉴权说明

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

结果说明

• 获取结果后，下次调用，不会再次返回之前获取过的结果
• 接口一次最多返回200个结果，人工审核结果数据默认保留7天，7天不获取会失效，异步检测结果默认保留4小时，超过4小时不获取会失效
• 接口请求频率建议1s一次，过快服务器会拒绝处理，客户可以根据业务需求进行适当调整
• 异步检测一般10s内会检测完成，异步机器检测结果建议尽快获取

接口耗时

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

历史版本

v4版本轮询模式文档请点此查看

请求

请求地址

请求头

请求参数

请求参数

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

公共参数

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

业务参数

请求体示例

version=v5.2&signature=xxx&secretId=xxx&businessId=xxx&timestamp=1677207014000&nonce=1234

响应

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

人工审核响应结果

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

人工审核响应体示例

{
    "code":200,
    "msg":"ok",
    "result":[
        {
            "antispam":{
                "taskId":"wet2h1hhoba8qbik9f3orljg00123rdh",
                "dataId":"1185546433254492160",
                "suggestion":2,
                "remark":"人审备注内容，填写备注才会返回",
                "resultType":2,
                "callback":"",
                "censorType":0,
                "censorSource":1,
                "censorRound":0,
                "censorTime":1639374062208,
                "censorLabels":[
                    {
                        "code":"1604386821661",
                        "customCode":"自定义标签编码",
                        "name":"审核标签名称",
                        "desc":""
                    },
                    {
                        "code":"1604386813202",
                        "customCode":"自定义标签编码",
                        "name":"审核标签名称",
                        "desc":""
                    }
                ],
                "isRelatedHit":false,
                "labels":[
                    {
                        "label":100,
                        "level":2,
                        "subLabels":[
                            {
                                "subLabel":"100001"
                            }
                        ]
                    }
                ]
            }
        }
    ]
}

异步检测响应结果

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

异步检测响应体示例

{
    "code": 200,
    "msg": "ok",
    "result": [
        {
            "antispam": {
                "taskId": "fx6sxdcd89fvbvg4967b4787d78a",
                "dataId": "dataId",
                "suggestion": 1,
		"suggestionLevel":2,
                "resultType": 1,
                "censorType": 0,
                "callback": "callback",
                "strategyVersions": [
                    {
                        "label": 100,
                        "version": "v1.0"
                    }
                ],
                "isRelatedHit": false,
                "labels": [
                    {
                        "label": 100,
                        "rate":1,
                        "level": 1,
                        "subLabels": [
                            {
                                "subLabel": "100001",
                                "details": {
                                     "keywords": [
                                        {
                                            "word": "xxx"
                                        }
                                     ],
                                     "libInfos": [
                                        {
                                            "type": 1,
                                            "entity": "xxx"
                                        }
                                     ],
                                     "anticheat": {
                                        "hitType": 5
                                     },
                                     "hitInfos": [
                                        {
                                            "value": "xxx",
                                            "positions": [
                                                {
                                                    "fieldName": "title",
                                                    "startPos": 0,
                                                    "endPos": 1
                                                }
                                            ]
                                        }
                                     ]
                                }
                            }
                        ]
                    }
                ]
            },
            "emotionAnalysis": {
                "taskId": "fx6sxdcd89fvbvg4967b4787d78a",
                "dataId": "dataId",
                "details": [
                    {
                        "positiveProb": 0.5,
                        "negativeProb": 0,
                        "sentiment": "positive"
                    }
                ]
            },
            "anticheat": {
                "taskId": "fx6sxdcd89fvbvg4967b4787d78a",
                "dataId": "dataId",
                "details": [
                    {
                        "suggestion": 20,
                        "hitInfos": [
                            {
                                "hitType": 5,
                                "hitMsg": "无SDK数据"
                            }
                        ]
                    }
                ]
            },
            "userRisk": {
                "taskId": "fx6sxdcd89fvbvg4967b4787d78a",
                "dataId": "xxx",
                "details": [
                    {
                        "account": "xxx",
                        "accountLevel": 2 
                    }
                ]
            },
            "language": {
                "taskId": "fx6sxdcd89fvbvg4967b4787d78a",
                "dataId": "dataId",
                "details": [
                    {
                        "type": "zh"
                    }
                ]
            }
        }
    ]
}

接入示例代码

开发工具集（SDK）接入

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

• 准备工作

准备步骤详见通用步骤

• 使用方法

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

API接入

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

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

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