Idempotency

POST /api/v1/shipments mendukung header Idempotency-Key untuk mencegah duplikasi (mis. retry network).

Aturan

Kondisi	Hasil
Key baru	Request dieksekusi normal; hasil disimpan 60 menit.
Key sama + payload sama	Response logis yang sama dikembalikan (field `replayed: true`).
Key sama + payload beda	`409 IDEMPOTENCY_CONFLICT`.
Key dipakai bersamaan (race)	Salah satu dieksekusi, sisanya 409 hingga selesai.

curl -X POST https://antarpaket.id/api/v1/shipments \
  -H "Authorization: Bearer ap_test_xxx" \
  -H "Idempotency-Key: order-12345" \
  ...

Gunakan key unik per order bisnis kamu (mis. order-12345), bukan UUID acak per retry.