检测结果查询

通过 taskId 查询异步文本审核任务的状态和结果。

POSThttps://tsafe.ilivedata.com/api/v1/text/async/check/result

任务状态 code 与审核结论 textSpam.result 含义不同，请分别判断。

请求参数

请求头

以下请求头均为必需。

Header	值	说明
`Content-Type`	`application/json; charset=UTF-8`	请求体格式
`Accept`	`application/json; charset=UTF-8`	响应格式
`X-AppId`	—	控制台「服务配置」中的项目编号
`X-TimeStamp`	—	请求发起时的 UTC 时间，采用 W3C 格式。格式示例：`2026-09-30T02:30:00Z`，实际请求需使用当前时间。
`Authorization`	—	签名值，计算方式见下文「请求签名」

请求体

参数	类型	必需	说明
`taskId`	`String`	必需	提交文本检测任务后返回的任务ID

请求示例

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

请求签名

按照帮助中心的请求签名计算 Authorization，使用以下接口参数。

签名参数	值
`HTTPMethod`	`POST`
`HostHeaderInLowercase`	`tsafe.ilivedata.com`
`HTTPRequestURI`	`/api/v1/text/async/check/result`

HTTP 响应

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

code：0 检测成功、1 检测失败、2 检测中、3 taskId 无效。textSpam.result：0 通过、1 建议审核、2 不通过。

响应字段

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

textSpam

字段	类型	说明
`content`	`String`	敏感词替换为星号后的文本，其他内容正常返回
`result`	`Number`	0:通过，1:建议审核，2:不通过
`tags`	`Array`	分类信息
`wordList`	`String[]`	敏感词列表

tags[]

所属字段：textSpam.tags。

字段	类型	说明
`tag`	`Number`	一级分类代码，参见分类编码对照表。
`tagName`	`String`	一级分类名称
`tagNameEn`	`String`	一级分类名称（英文）
`level`	`Number`	分类级别，0：正常，1：疑似，2：异常
`confidence`	`Number`	置信度，0～100之间的值，数值越大，表示检测文本为广告的可能性越大。（仅tag为150时，返回该字段）
`subTags`	`Array`	二级分类

subTags[]

所属字段：textSpam.tags[].subTags。

字段	类型	说明
`subTag`	`Number`	二级分类详细编码请参考分类编码对照表
`subTagName`	`String`	二级分类名称
`subTagNameEn`	`String`	二级分类名称（英文）
`wordList`	`String[]`	命中详情

响应示例

{
  "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
}

错误码

通用请求错误与鉴权错误请参考帮助中心的通用错误码。

检测失败、检测中及 taskId 无效通过 code 表示，具体取值见上方响应字段说明。