Tekrar anahtarı (Idempotency-Key) · MultiKolay Geliştiriciler

Yazan isteği güvenle tekrarla. Bağlantı koparsa aynı iş iki kez yapılmaz.

POST, PATCH, PUT ve DELETE isteklerine Idempotency-Key başlığı ekleyebilirsin. Aynı anahtarla aynı istek 24 saat içinde tekrar gelirse iş yeniden yapılmaz; ilk yanıt aynen döner ve yanıtta Idempotent-Replayed: true başlığı olur.

curl -X POST https://api.multikolay.com/v1/siparisler/order_01M599DZ…/kargo \
  -H "Authorization: Bearer $MK_API_ANAHTARI" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: kargo-6-2026-10-19" \
  -d '{ "firma": "Yurtiçi Kargo", "takip_no": "123456789" }'

Anahtar 1–255 karakter. Her yeni iş için yeni anahtar üret (UUID ya da kendi kayıt numaran).
Aynı anahtar farklı bir gövdeyle gelirse 422 tekrar_anahtari_kullanildi.
İlk istek hâlâ işlenirken aynı anahtar gelirse 409 tekrar_suruyor; biraz bekleyip tekrar dene.
Anahtar mağaza ve API anahtarı başınadır; başka entegrasyonların anahtarlarıyla çakışmaz.

Ne zaman şart

Para, stok ya da sipariş durumu değiştiren her istekte. Zaman aşımında "gitti mi gitmedi mi" sorusunun tek güvenli cevabı aynı anahtarla tekrar göndermek.