幂等性

重试 POST /v1/pack，而不会创建第二个任务。

在 POST /v1/pack（或 POST /v1/projects/{id}/pack）请求中发送 Idempotency-Key。使用相同的键重试，会得到同一个任务，且只扣费一次。

Bash

curl -X POST https://runner.cargoduo.com/v1/pack \
  -H "Authorization: Bearer $CARGODUO_API_KEY" \
  -H "Idempotency-Key: order-1042-v1" \
  -H "Content-Type: application/json" \
  -d @request.json

规则	说明
时间窗口	24 小时，按组织计
键	任意字符串，最长 128 个字符：可使用 UUID 或您的订单号
重放	返回原任务，并带有 `Idempotent-Replayed: true`。任务已结束时返回 `200`，否则返回 `202`
过长	`400 idempotency_key_invalid`

每个逻辑请求使用一个键。请求体有改动时，需要使用新键。

相关内容#

相关内容