图片标注

人工标注

客户可通过此接口，按图片审核任务 ID 单条或批量提交人工标注结果。此接口使用企业 CID 和企业密钥鉴权；图片标注回调 API 使用 X-AppId，两者的请求体和签名格式不同。

POSThttps://console-api.ilivedata.com/api/pir/mark

Header	值	说明
`Content-Type`	`application/json;charset=UTF-8`	请求体使用 JSON
`Accept`	`application/json;charset=UTF-8`	建议设置，指定期望的响应格式
`Corp-Cid`	企业 CID	企业管理员可在“控制台 > 企业信息”查看；不是项目编号
`X-TimeStamp`	当前 UTC 时间	W3C 格式，例如 `2026-10-19T02:30:00Z`；调用时替换为当前时间
`Authorization`	签名值	按下方“提交请求签名”计算，使用企业密钥

参数	是否必需	类型	描述
`pid`	必需	Number	图片项目编号
`taskIds`	必需	Array<String>	已有图片审核任务 ID 列表
`result`	必需	Number	`0`：通过；`2`：不通过
`tag`	条件必需	Number 或 Array<Number>	`result=2` 时必填；`result=0` 时可省略或传 `0`。支持单个或多个一级类别编号
`operator`	可选	String	操作人；未传时默认为 `openApiUser`

图片一级类别编号：100 涉政、110 暴恐、120 违禁、130 色情、140 性感、150 广告、160 涉价值观、180 未成年保护、200 二维码/小程序码/条形码。实际可用类别以项目配置为准。

{"pid":81000001,"taskIds":["image_task_id"],"result":2,"tag":[100,130],"operator":"user_a"}

请按上表传入参数，确保任务 ID、标注结果和标签编号有效。

将请求参数编码为 UTF-8 JSON，按以下规则生成用于签名和发送的请求体：
- 使用紧凑格式，不添加缩进、换行或字段间空格；字符串值中的空格必须保留。
- 保持对象字段顺序和数组元素顺序，不对字段排序。
- 中文等 Unicode 字符和斜杠 / 保持原字符，不使用 Unicode 或斜杠转义；双引号、反斜杠和控制字符按 JSON 规则转义。
- pid、result 和标签编号使用整数表示，不使用小数或科学计数法。
对上述 JSON 的 UTF-8 字节计算 SHA-256，得到小写十六进制摘要。发送请求时使用相同的 JSON 字符串，避免签名后再次序列化。
以下六项用 ASCII 换行符 \n 连接，末尾不添加换行：
```
POST
console-api.ilivedata.com
/api/pir/mark
<步骤 1 的 SHA-256 十六进制摘要>
Corp-Cid:<与请求头完全相同的企业 CID>
X-TimeStamp:<与请求头完全相同的时间戳>
```
使用其他部署域名时，签名中的 Host 使用实际请求的主机名，不包含协议和端口；路径不包含查询参数。请求和签名中的域名统一使用小写并保持一致。
使用企业密钥对上述字符串计算 HMAC-SHA256，将二进制摘要进行 Base64 编码，写入 Authorization 请求头。
```
Authorization = Base64(HMAC-SHA256(CorpSecret, StringToSign))
```

成功时返回：

{"code":0,"msg":"success.","data":true}

参数缺失或鉴权失败会返回错误。下游标注服务未返回成功时，此接口返回通用错误 code=999、data=[]；调用方需检查业务 code。