Idempotency

Thử lại POST /v1/pack mà không tạo tác vụ thứ hai.

Gửi Idempotency-Key cùng POST /v1/pack (hoặc POST /v1/projects/{id}/pack). Thử lại với cùng khóa, bạn sẽ nhận lại đúng tác vụ đó và chỉ bị tính phí một lần.

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

Quy tắc	Chi tiết
Khung thời gian	24 giờ, theo tổ chức
Khóa	Chuỗi bất kỳ, tối đa 128 ký tự: một UUID hoặc mã đơn hàng của bạn
Phát lại	Tác vụ ban đầu, kèm `Idempotent-Replayed: true`. `200` nếu đã kết thúc, `202` nếu chưa
Quá dài	`400 idempotency_key_invalid`

Mỗi yêu cầu nghiệp vụ dùng một khóa riêng. Nội dung yêu cầu thay đổi thì cần khóa mới.

Liên quan

Tạo tác vụ xếp hàngKiểm tra yêu cầu, tạm giữ mức giá tối đa từ credit của bạn và đưa tác vụ vào hàng đợi.LỗiMột cấu trúc lỗi duy nhất, mã lỗi ổn định, quy tắc thử lại rõ ràng.

Liên quan#

Liên quan