确认术语并继续翻译
手动触发任务的翻译阶段 —— 仅当创建任务时传了 auto_apply_terms=false,且 TB_SCAN 已完成时使用。等价于前端"术语审核 → 确认并继续"按钮。
使用时机
集成流程(auto_apply_terms=false):
POST /tasks/create(body 里auto_apply_terms: false)→ 立刻返回task_id- 后端触发 TB_SCAN,完成后给你发
term_scan.completed回调,detail.requires_confirmation=true - 调
GET /tasks/terms拿到扫描出的术语列表(每项带id) - 人工/业务侧审核;如需修改 →
/tasks/terms/update;如需剔除 →/tasks/terms/delete - 调本接口 → 系统触发 TRANSLATE 工作流;后续回到正常的
tmMatching/tbMatching/ ... /task.completed回调节奏
请求地址
POST {BASE_URL}/api/open/v1/tasks/confirm-terms鉴权 Header
和 创建翻译任务 完全一样。
请求参数(Body)
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
task_id | string | 是 | 目标任务 ID |
响应
成功(HTTP 200):
json
{
"success": true,
"code": 0,
"msg": "ok",
"trace_id": "...",
"data": {
"task_id": "68a12cb7e1f9a88b4ea23c77",
"job_id": "translate_open_...",
"execution_id": "projects/.../executions/..."
}
}错误码
| code | 说明 |
|---|---|
| 400 | 缺少 task_id |
| 401 | 签名校验失败 |
| 403 | 任务不属于该 App Key |
| 404 | 任务不存在 |
| 409 | 任务不是"等待确认"状态(可能没传 auto_apply_terms=false,或 TB_SCAN 还没完,或已经触发过 TRANSLATE) |
| 502 | 工作流触发失败 |
| 500 | 系统错误 |
示例
bash
APP_KEY="5685414646a54423c891d87194d87f3f"
APP_SECRET="<你的 App Secret>"
TASK_ID="68a12cb7e1f9a88b4ea23c77"
BASE_URL="https://api.loxily.com"
TIMESTAMP=$(date +%s)
BODY="{\"task_id\":\"${TASK_ID}\"}"
SIGN=$(printf '%s' "${TIMESTAMP}${BODY}${APP_SECRET}" | md5)
curl -s -X POST "${BASE_URL}/api/open/v1/tasks/confirm-terms" \
-H "Content-Type: application/json" \
-H "X-Loxily-AppKey: ${APP_KEY}" \
-H "X-Loxily-Timestamp: ${TIMESTAMP}" \
-H "X-Loxily-Sign: ${SIGN}" \
--data "${BODY}"前端联动
页面 UI 上的"确认并继续"按钮和本接口是同一件事 —— 无论集成方通过 API 确认还是运营通过页面点击,任务都会从 waiting_confirmation 状态进入 TRANSLATE。谁先确认就谁触发,另一侧会看到状态变为"已触发"。