批量删除术语
按 id 批量删除项目术语库里的术语。单次最多 100 条,同步返回。
请求地址
POST {BASE_URL}/api/open/v1/terms/delete鉴权 Header
和 创建翻译任务 完全一样。
请求参数(Body)
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
ids | string[] | 是 | 术语 id 数组,最多 100 条 |
响应
json
{
"success": true,
"code": 0,
"msg": "ok",
"trace_id": "...",
"data": {
"requested_count": 3,
"deleted_count": 2,
"invalid_ids": ["not-an-oid"],
"not_found_ids": ["a0000000000000000000000b"]
}
}requested_count:你传进来的 id 总数deleted_count:实际删除的行数invalid_ids:格式不合法的 id 列表not_found_ids:格式合法但当前项目下不存在的 id 列表
删除同时会排队一次向量同步(把对应 record 的嵌入标记为 delete),非阻塞。
错误码
| code | 说明 |
|---|---|
| 400 | ids 为空 / 超过 100 / 任何元素不是字符串 |
| 401 | 签名校验失败 / 时间戳过期 |
| 404 | appKey 无效 |
| 500 | 系统错误 |
示例
bash
APP_KEY="5685414646a54423c891d87194d87f3f"
APP_SECRET="<你的 App Secret>"
BASE_URL="https://api.loxily.com"
TIMESTAMP=$(date +%s)
BODY='{"ids":["69e9b99c04e32e3f20afbbdb","69e9b99c04e32e3f20afbbda"]}'
SIGN=$(printf '%s' "${TIMESTAMP}${BODY}${APP_SECRET}" | md5)
curl -s -X POST "${BASE_URL}/api/open/v1/terms/delete" \
-H "Content-Type: application/json" \
-H "X-Loxily-AppKey: ${APP_KEY}" \
-H "X-Loxily-Timestamp: ${TIMESTAMP}" \
-H "X-Loxily-Sign: ${SIGN}" \
--data "${BODY}"