Skip to content

确认术语并继续翻译

手动触发任务的翻译阶段 —— 仅当创建任务时传了 auto_apply_terms=false,且 TB_SCAN 已完成时使用。等价于前端"术语审核 → 确认并继续"按钮。

使用时机

集成流程(auto_apply_terms=false):

  1. POST /tasks/create(body 里 auto_apply_terms: false)→ 立刻返回 task_id
  2. 后端触发 TB_SCAN,完成后给你发 term_scan.completed 回调,detail.requires_confirmation=true
  3. GET /tasks/terms 拿到扫描出的术语列表(每项带 id
  4. 人工/业务侧审核;如需修改 → /tasks/terms/update;如需剔除 → /tasks/terms/delete
  5. 调本接口 → 系统触发 TRANSLATE 工作流;后续回到正常的 tmMatching / tbMatching / ... / task.completed 回调节奏

请求地址

POST {BASE_URL}/api/open/v1/tasks/confirm-terms

鉴权 Header

创建翻译任务 完全一样。

请求参数(Body)

参数类型必填说明
task_idstring目标任务 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。谁先确认就谁触发,另一侧会看到状态变为"已触发"。