Check Result Query

Query an asynchronous text moderation task using its taskId.

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

The task status code and moderation decision textSpam.result are separate fields.

Request Parameters

Request Headers

All headers below are required.

Header	Value	Description
`Content-Type`	`application/json; charset=UTF-8`	Request body format
`Accept`	`application/json; charset=UTF-8`	Response format
`X-AppId`	—	Project ID from Console → Service Configuration
`X-TimeStamp`	—	UTC time when the request is sent, in W3C format. Format example: `2026-09-30T02:30:00Z`. Use the current time for actual requests.
`Authorization`	—	See Request Signature below

Request Body

Parameter	Type	Required	Description
`taskId`	`String`	Required	The task ID returned after submitting a text detection task.

Request Example

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

Request Signature

Calculate Authorization using Request Signature with these parameters.

Signing Parameter	Value
`HTTPMethod`	`POST`
`HostHeaderInLowercase`	`tsafe.ilivedata.com`
`HTTPRequestURI`	`/api/v1/text/async/check/result`

HTTP Response

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

code: 0 succeeded, 1 failed, 2 in progress, 3 invalid taskId. textSpam.result: 0 pass, 1 review recommended, 2 fail.

Response Fields

Field	Type	Description
`errorCode`	`Number`	Error code: 0 means success
`errorMessage`	`String`	Error message
`code`	`Number`	Task status: 0: succeeded, 1: failed, 2: in progress, 3: invalid taskId
`taskId`	`String`	Unique identifier of the detection task
`language`	`String`	Detected language
`textSpam`	`Object`	Text detection result
`warning`	`Boolean`	Alert for custom advertising words, configured when adding blacklist entries in the console
`startTime`	`Number`	Timestamp when text detection was called
`endTime`	`Number`	Timestamp when the text detection result was returned

textSpam

Field	Type	Description
`content`	`String`	Text with sensitive words replaced by asterisks; other content is returned unchanged
`result`	`Number`	0: pass, 1: recommended for review, 2: fail
`tags`	`Array`	Classification information
`wordList`	`String[]`	List of sensitive words

tags[]

Parent field: textSpam.tags.

Field	Type	Description
`tag`	`Number`	First-level category code; see Classification Codes.
`tagName`	`String`	First-level category name
`tagNameEn`	`String`	First-level category name in English
`level`	`Number`	Classification level: 0: normal, 1: suspected, 2: abnormal
`confidence`	`Number`	Confidence from 0 to 100. A higher value indicates a greater likelihood of advertising. Returned only when tag is 150
`subTags`	`Array`	Second-level classifications

subTags[]

Parent field: textSpam.tags[].subTags.

Field	Type	Description
`subTag`	`Number`	Second-level category code; see Classification Codes
`subTagName`	`String`	Second-level category name
`subTagNameEn`	`String`	Second-level category name in English
`wordList`	`String[]`	Matched words

Response Example

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

Error Codes

For common request and authentication errors, see Common Error Codes.

Task failures, pending tasks, and invalid task IDs are reported by code; see the response field definitions above.