图片标注回调 API

接口说明

图片人工标注完成后，平台会将图片原始审核数据和人工修改结果推送至客户配置的回调 URL。

在“项目查看 > 服务配置 > 标注 API 回调”中配置回调 URL。配置完成后，人工标注结果默认进行回调。人工标注支持在“项目查看 > 数据查询”中对单条或多条数据进行修改。

POSTcallbackUrl

请求参数

请求头

以下请求头均为必需。

Header	值	说明
`Content-Type`	`application/json;charset=UTF-8`	请求体类型
`Accept`	`application/json;charset=UTF-8`	接受的返回类型
`X-AppId`	—	项目的唯一标识，即“控制台 > 服务配置”中的项目编号
`X-TimeStamp`	—	请求的 UTC 时间戳，按 W3C 标准格式化，例如 `2010-01-31T23:59:59Z`
`Authorization`	—	签名值，计算方式见请求签名

请求体

请求体为 JSON 对象。

参数	是否必需	类型	描述
`appId`	必需	String	项目编号
`imageData`	必需	Array	图片的原始审核数据
`markData`	必需	Object	人工修改后的标注数据

请求示例

{
  "appId": "81000001",
  "imageData": [
    {
      "taskId": "us_b0db751223584cf5af9d5c469bb9e4d1_1694159664104",
      "strategyId": "DEFAULT",
      "url": "https://example.com/image.jpg",
      "displayUrl": "https://example.com/image.jpg",
      "code": 0,
      "result": 0,
      "imageCheckType": [],
      "tags": [],
      "subTags": [],
      "userId": null,
      "md5": "CC6300BC04E46883944D0C38BCDA6A02"
    }
  ],
  "markData": {
    "markResult": "2",
    "markTag": [
      "130"
    ]
  }
}

请求签名

通过 HTTP 请求 Header 发送签名：

Authorization: ****

签名计算步骤如下：

将请求体 JSON 字符串按 UTF-8 编码并计算 SHA-256，再转换为十六进制字符串。结果不是 Base64 字符串。
```
CanonicalizedQueryString = hex(sha256(jsonBody))
```
按以下格式构造待签名字符串。各部分之间使用一个 ASCII 换行符 \n：
```
StringToSign = HTTPMethod + "\n"
             + CallbackUrl + "\n"
             + CanonicalizedQueryString + "\n"
             + "X-AppId:" + SAME_APPID_IN_HEADER + "\n"
             + "X-TimeStamp:" + SAME_TIMESTAMP_IN_HEADER
```
其中：
- HTTPMethod 为 POST。
- CallbackUrl 为客户在“标注 API 回调”中配置的回调 URL。
- SAME_APPID_IN_HEADER 和 SAME_TIMESTAMP_IN_HEADER 必须分别与请求 Header 中的 X-AppId 和 X-TimeStamp 完全一致。
以 StringToSign 为待签名字符串、secretKey 为密钥，使用 HMAC-SHA256 计算签名。
将计算结果转换为 Base64 字符串。
将 Base64 字符串写入请求 Header 的 Authorization 字段。