← 系统接入

分清重试、修正和重算

接入程序根据 HTTP 状态码和任务状态决定下一步,让重复提交仍然指向同一次计算。

网络断开后

先找出第一次保存的输入文件与幂等键。再次发送同一个请求,取回关联任务编号。如果已保存任务编号,可以直接查状态。

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

状态码怎样处理

响应推荐动作
400 / 422按错误信息修正请求;变更场景后使用新业务编号。
401 / 404核对密钥是否有效、账号是否启用,以及任务和密钥是否位于同一工作空间。
409提交时核对是否给不同输入复用了同一个幂等键;下载时核对任务是否已完成。
413核对 JSON 大小,单次上限 8 MiB。
429 / 503遵照 Retry-After,加少量随机等待后,以同一输入和幂等键重试。
410任务已过期。确需重新计算时分配新幂等键。

怎样避免第二次求解

幂等摘要保留 24 小时。业务系统可按“工作空间、业务请求编号、输入版本”记录映射,网络超时后先复用原记录。用户确实改变订单、车辆或规则时,再生成新的业务请求编号。