检测记录查询（游标分页）

更新时间:

按游标分页查询文本检测记录，适合连续拉取大量记录。此接口由调用方主动请求，并非服务端推送回调。

POSThttps://tsafe.ilivedata.com/api/v1/stats/text/check/records/scroll

仅支持查询一个月内的数据，每页最多 2,000 条。请求与响应均为 JSON，使用 Authorization 签名鉴权。

请求参数

请求头

以下请求头均为必需。

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

请求体

参数 类型 必需 说明
apps Number[] 可选 项目编号列表；不传时使用请求头中的 X-AppId。
strategies String[] 可选 策略 ID 列表。
results Number[] 可选 检测结果列表：0 通过、1 疑似、2 不通过。
languages String[] 可选 语种列表。
startAt Number 必需 查询开始时间，毫秒级时间戳，仅支持一个月内的数据。
endAt Number 必需 查询结束时间，毫秒级时间戳。
sortOrder String 可选 排序参数：ASC 升序、DESC 降序，默认 DESC。当前实现限制见下方说明。
size Number 必需 每页记录数，范围 1～2000。
cursor Object 可选 首次请求不传，续页时原样传入上次响应中的 cursor。

当前服务实现接收 sortOrder，但尚未将其传入底层查询，实际仍按默认 DESC 排序；不要依赖 ASC 返回升序结果。

cursor

字段 类型 必需 说明
taskId String 必需 游标对应的任务 ID。
timestamp Number 必需 游标时间，毫秒级时间戳。

请求示例

以下时间戳仅用于展示格式，实际请求请替换为一个月内的查询范围。

首次请求

{
  "size": 1000,
  "startAt": 1791936000000,
  "endAt": 1792022400000
}

后续请求

保持项目、时间范围和筛选条件不变，将上一次响应的 cursor 原样传入。

{
  "size": 1000,
  "startAt": 1791936000000,
  "endAt": 1792022400000,
  "cursor": {
    "timestamp": 1792022390000,
    "taskId": "ap_example_task_001"
  }
}

请求签名

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

签名参数 值
HTTPMethod POST
HostHeaderInLowercase tsafe.ilivedata.com
HTTPRequestURI /api/v1/stats/text/check/records/scroll

HTTP 响应

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

响应字段

字段 类型 说明
code Number 0 表示查询成功，非 0 表示异常，原因见 msg。
msg String 结果描述或异常原因。
data Object 查询结果。

data

字段 类型 说明
cursor Object 用于后续请求的游标，结构同请求体的 cursor。
records Object[] 检测记录列表，字段见下文。

records[]

未提供或不存在的可选字段可能不返回。用户等级、IP、消息、支付、渠道和注册信息来自原检测请求的附加数据，具体值类型以传入值为准。

字段 类型 说明
input String 检测源文本。
taskId String 任务标识。
result Number 检测结果：0 通过、1 疑似、2 不通过。
checkAt Number 检测时间，毫秒级时间戳。
strategy String 策略 ID。
language String 语种。
tags Number[] 一级分类代码。
subTags Number[] 二级分类代码。
wordlist String[] 命中的违规词。
userId String 用户唯一标识。
extra Object 附加数据。

响应示例

{
  "code": 0,
  "msg": "Success.",
  "data": {
    "cursor": {
      "timestamp": 1792022390000,
      "taskId": "ap_example_task_001"
    },
    "records": [
      {
        "taskId": "ap_example_task_001",
        "strategy": "DEFAULT",
        "result": 0,
        "input": "Hello",
        "userId": "user001",
        "language": "en",
        "checkAt": 1792022390000
      }
    ]
  }
}