标注回调API

接收控制台人工标注后的审核结果变更。

POSTcallbackUrl

在控制台「服务配置 → 人工标注 → 回调 URL」配置接收地址。

请求参数

请求头

以下请求头均为必需。

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

请求体

参数	类型	必需	说明
`appId`	`String`	必需	项目编号
`textData`	`Array`	必需	文本的原数据
`markData`	`Object`	必需	修改数据

markTag 已废弃，请使用 markTags 获取最新类型列表；markResult 为最新审核结果。

请求示例

{
  "appId": "",
  "textData": [
    {
      "taskId": "",
      "strategyId": "",
      "language": "",
      "stext": "",
      "word": "",
      "userId": "",
      "result": "",
      "tag": "",
      "subTag": ""
    }
  ],
  "markData": {
    "markResult": "",
    "markTag": "",
    "markTags": ""
  }
}

回调签名

按以下规则验证 Authorization。本回调将完整 CallbackUrl 加入签名，不使用请求接口中分开的主机名与路径。

签名参数	值
`HTTPMethod`	`POST`
`CallbackUrl`	控制台配置的完整回调 URL

对 UTF-8 编码的请求体计算 SHA256，并将摘要转为十六进制字符串。
按下方规则构造 StringToSign。
使用 secretKey 计算 HMAC-SHA256，将结果转为 Base64 后，与 Authorization 比较。

CanonicalizedQueryString = hex(sha256(jsonBody))
StringToSign = HTTPMethod + "\n" +
               CallbackUrl + "\n" +
               CanonicalizedQueryString + "\n" +
               "X-AppId:" + SAME_APPID_IN_HEADER + "\n" +
               "X-TimeStamp:" + SAME_TIMESTAMP_IN_HEADER