网页检测结果查询

请求规范

  • 请求 URL:

https://msafe.ilivedata.com/api/v1/text/async/check/result

  • 接口描述:

该接口用于获取文本检测结果

  • HTTP 请求Header:
Header 描述
Content-Type application/json;charset=UTF-8 请求体类型
Accept application/json;charset=UTF-8 接受的返回类型
X-AppId 项目或应用的唯一标识符
X-TimeStamp 请求的UTC时间戳。需要把时间戳按W3C标准格式化,例如: 2010-01-31T23:59:59Z. (http://www.w3.org/TR/xmlschema-2/#dateTime)。
Authorization 请求签名,签名计算规则请参考帮助中心的请求签名
  • 请求方法:POST

  • 请求体JSON对象:

参数 必需 类型 描述
taskId 必需 String 提交文本检测任务后返回的任务ID
  • 请求体示例:

    JSON request

  {
    "taskId": "us_******************"
  }

请求签名

该接口需要在请求 Header 中传入 Authorization 签名。签名计算规则请参考帮助中心的请求签名

HTTP响应

Content-Type: application/json;charset=UTF-8

结果为JSON格式,请参考以下示例。

  • HTTP响应

返回json字段说明:

字段名 类型 描述
errorCode Number 响应码
errorMessage String 响应信息
code Number 状态码,定义为:0:检测成功,1:检测失败,2:检测中,3:taskId无效
taskId String 区分不同次调用的唯一标识
language String 语种
textSpam json对象 结果信息
warning Boolean 自定义广告词的报警信息,在控制台上添加黑名单时配置
startTime Number 时间戳,代表检测文本调用时间
endTime Number 时间戳,代表检测文本结果返回时间

audioSpams:

字段名 类型 描述
startTime Number 命中的音频段开始时间,单位秒
endTime Number 命中的音频段结束时间,单位秒
text String 音频段文本信息
vpr Boolean 命中声纹检测
tags json数组 分类信息

tags:

字段名 类型 描述
tag Number 分类信息
100:涉政;110:暴恐;120:违禁;130:色情;150:广告;160:辱骂;
170:仇恨言论;180:未成年保护;190:敏感热点;510:少数民族语言检测;
220:私人交易;900:其他;999:用户自定义类
tagName String 一级分类名称
tagNameEn String 一级分类名称(英文)
level Number 分类级别,0:正常,1:疑似,2:异常
subTags json数组 二级分类

subTags:

字段名 类型 描述
subTag Number 二级分类详细编码请参考 分类编码对照表
subTagName String 二级分类名称
subTagNameEn String 二级分类名称(英文)
wordList 字符串数组 命中详情
  • 响应示例:

    JSON response

     {
        "errorCode": 0,
        "code": 0,
        "textSpam": {
            "content": "****",
            "result": 2,
            "tags": [
                {
                    "tag": 160,
                    "level": 2,
                    "tagName": "辱骂",
                    "tagNameEn": "insults",
                    "subTags": [
                        {
                            "subTag": 160001,
                            "subTagName": "谩骂人身攻击",
                            "subTagNameEn": "insults and personal attacks",
                            "wordList": [
                                "fuck"
                            ]
                        }
                    ]
                }
            ],
            "wordList": [
                "fuck"
            ]
         },
         "taskId": "c01b212f-3e31-4a2e-8346-b6f6ce3a3456",
         "language": "English",
         "startTime": 1660103900367,
         "endTime": 1660103900374
     }

错误码

Http状态码 错误码 错误消息
200 0 此字段省略
405 1004 Method Not Allowed
411 1007 Not Content Length
400 1002 API Not Found
400 1003 Bad Request
401 1102 Unauthorized Client
401 1106 Missing Access Token
401 1107 Invalid Token
401 1108 Expired Token
401 1110 Invalid Client
200 1200 Downloads failed or base64 value invalid
401 2000 Missing Parameter
401 2001 Invalid Parameter