检测任务提交

提交文本审核任务，获取 taskId 后查询结果或接收回调。

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

文本使用 UTF-8 编码，每次最多 2,048 个字符。建议在控制台配置回调地址及密钥。

请求参数

以下请求头均为必需。

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

未传 strategyId 时，使用 DEFAULT 策略。

参数	类型	必需	说明
`content`	`String`	必需	检测的文本，此文本为不超过2048个字符的UTF-8编码字符串
`strategyId`	`String`	可选	策略编号，不传时使用默认策略DEFAULT
`country`	`String`	可选	国家代码，不传时使用默认
`userId`	`String`	可选	唯一的终端用户ID，用户ID应当不超过64个字符
`sessionId`	`String`	可选	用户会话ID，会话ID应当不超过64个字符。
`receiverId`	`String`	可选	接收者ID，接收者ID应当不超过64个字符。
`userName`	`String`	可选	用户名、昵称，用户名应当不超过32个字符。
`userLevel`	`Number`	可选	用户等级
`totalPay`	`Number`	可选	用户充值金额，最多支持小数点后2位
`registrationDate`	`Number`	可选	用户注册时间，10位数时间戳
`msgCount`	`Number`	可选	消息发送次数
`msgType`	`String`	可选	消息类型
`pkgChannel`	`String`	可选	安装包渠道
`userIp`	`String`	可选	用户IP地址
`did`	`String`	可选	用户设备ID
`dtype`	`String`	可选	`1` iPhone、`2` Android、`3` iPad、`4` Windows Phone； `5` PC、`6` Web、`7` WAP。
`extra`	`Object`	可选	附加键值数据，例如 `{"server":"123","version":"456"}`。
`checkTags`	`Array`	可选	检测的一级分类，取值见下方类别表。
`callbackUrl`	`String`	可选	回调地址（不推荐，建议在控制台配置回调地址以及密钥）
`callbackSecretKey`	`String`	可选	回调密钥（不推荐，建议在控制台配置回调地址以及密钥）

checkTags 支持以下一级分类代码。

{
  "content": "fuck you",
  "userId": "1234556",
  "strategyId": "123"
}

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

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

提交成功不代表审核完成。请使用 taskId 查询结果，或接收审核结果回调。

{
  "errorCode": 0,
  "taskId": "us_**************************"
}

通用请求错误和鉴权错误请参考帮助中心的通用错误码。本接口补充说明如下：

HTTP 状态码	错误码	错误消息	本接口触发条件
400	2000	Missing Parameter	请求体 JSON 缺少 `content`。
400	2102	Input Too Long	`content` 超过 2,048 个字符。
429	1104	Out of Rate Limit	请求频率超过 20 条/秒，或长度超过 100 个字符的文本，其字符总数超过 1K 字符/秒。

以上限额为文档中的默认值；项目已扩容时，以实际配置为准。