同步批量检测

更新时间:

批量提交文本并同步获取审核结果，每次最多 100 条。

POSThttps://tsafe.ilivedata.com/api/v2/text/batchCheck

结果通过 checkResults 返回，每条记录包含独立的 errorCode。

请求参数

请求头

以下请求头均为必需。

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 — 签名值，计算方式见下文「请求签名」

请求体

未传 contents[].strategyId 时，使用 DEFAULT 策略。

参数 类型 必需 说明
contents Array 必需 批量审核请求内容, 数量不超过100
contents[].id String 可选 数据ID
contents[].content String 必需 检测文本
contents[].strategyId String 可选 策略编号
contents[].country String 可选 国家代码
contents[].userId String 可选 唯一的终端用户ID。 用户ID应当不超过64个字符。
contents[].userName String 可选 用户名、昵称。 用户名应当不超过32个字符。
contents[].userLevel Number 可选 用户等级
contents[].userIp String 可选 用户IP地址
contents[].sessionId String 可选 用户会话ID。 会话ID应当不超过64个字符。
contents[].receiverId String 可选 接收者ID。 接收者ID应当不超过64个字符。
contents[].totalPay Number 可选 用户充值金额。 最多支持小数点后2位。
contents[].registrationDate Number 可选 用户注册时间。 10位数时间戳。
contents[].msgCount Number 可选 消息发送次数
contents[].msgType String 可选 消息类型
contents[].pkgChannel String 可选 安装包渠道
contents[].did String 可选 用户设备ID
contents[].dtype String 可选 1 iPhone、2 Android、3 iPad、4 Windows Phone；
5 PC、6 Web、7 WAP。
contents[].extra Object 可选 附加键值数据，例如 {"server":"123","version":"456"}。
contents[].checkTags Array 可选 检测的一级分类，取值见下方类别表。

可选检测类别

contents[].checkTags 支持以下一级分类代码。

代码 类别
100 涉政
110 暴恐
120 违禁
130 色情
150 广告
160 辱骂
170 仇恨言论
180 未成年保护
190 敏感热点
220 私人交易
410 违规表情
420 昵称相关
999 自定义

请求示例

{
  "contents": [
    {
      "id": "1",
      "content": "测试语句1",
      "strategyId": "DEFAULT"
    },
    {
      "id": "2",
      "content": "测试语句2",
      "strategyId": "DEFAULT"
    }
  ]
}

请求签名

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

签名参数 值
HTTPMethod POST
HostHeaderInLowercase tsafe.ilivedata.com
HTTPRequestURI /api/v2/text/batchCheck

HTTP 响应

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

响应字段

字段 类型 说明
errorCode Number 错误码，0表示成功
errorMessage String 错误消息
checkResults Array 结果信息

checkResults[]

字段 类型 说明
id String 返回请求中的id,请求中不传id参数则此处为空
errorCode Number 错误码，0表示成功
textSpam Object 结果信息
taskId String 区分不同次调用的唯一标识
language String 语种
startTime Number 时间戳，代表检测文本调用时间
endTime Number 时间戳，代表检测文本结果返回时间

textSpam

每条结果的字段：checkResults[].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,
  "errorMessage": "OK",
  "checkResults": [
    {
      "errorCode": 0,
      "textSpam": {
        "content": "fuck",
        "result": 0
      },
      "taskId": "367ef301-c627-4ae7-b23f-93d8219ade23",
      "language": "en",
      "startTime": 1699265265989,
      "endTime": 1699265268714,
      "id": "1"
    },
    {
      "errorCode": 0,
      "textSpam": {
        "content": "caonima",
        "result": 1,
        "tags": [
          {
            "tag": 999,
            "tagName": "用户自定义 ",
            "level": 1,
            "subTags": [
              {
                "subTag": 999001,
                "subTagName": "用户自定义敏感词一类",
                "wordList": [
                  "caonima"
                ]
              }
            ]
          }
        ],
        "wordList": [
          "caonima"
        ]
      },
      "taskId": "4967e9d1-f4ca-47de-aa52-6e6b0372ddcc",
      "language": "Italian",
      "companyId": "1",
      "startTime": 1699265269127,
      "endTime": 1699265269138,
      "adRisk": 1,
      "id": "2"
    }
  ]
}

错误码

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

文本相关补充说明见同步单条检测 — 错误码。批量结果中还需检查每条记录的 errorCode。