← 系统接入

从 TMS 提交一批订单

把完整场景包放进 scenario,用同一个业务请求编号贯穿提交和断线重试。

发送请求

准备客户系统导出的 scenario.json。发出请求前,把本批输入和生成的一次性 REQUEST_ID 一起保存;幂等键采用 1 至 180 个可打印 ASCII 字符,不带空格。

jq '{scenario: .}' scenario.json | 
  curl --fail-with-body -sS -D response.headers \
    -H "Authorization: Bearer $ROUTEMIND_KEY" \
    -H "Idempotency-Key: $REQUEST_ID" \
    -H 'Content-Type: application/json' \
    --data-binary @- "$ROUTEMIND_URL/api/v1/jobs" > job.json

保存任务回执

服务接受请求时返回 202 Accepted,响应中的 id 是任务编号;status_url 和 result_url 为相对路径。用回执中的地址跟踪同一任务。

JOB_ID=$(jq -er .id job.json)
STATUS_PATH=$(jq -er .status_url job.json)
RESULT_PATH=$(jq -er .result_url job.json)

提交边界

每次请求最多接收 8 MiB JSON。缺少完整 scenario 或结构校验失败通常返回 422;超过请求体积上限返回 413。新输入需分配新的幂等键。