Idempotency (Tekrarlanan İstek Koruması)

Ağ hatası nedeniyle bir isteği tekrar göndermeniz gerektiğinde, aynı işlemin iki kez uygulanmasını önlemenin standart yolu Idempotency Key'dir.

Dürüstlük notu: Bu platformda şu an gerçek, çalışan hiçbir POST/PATCH/DELETE uç noktası yoktur (yalnızca GET uç noktaları canlıdır) — bu yüzden idempotency mekanizması henüz devrede DEĞİLDİR. Bu sayfa, yazma uç noktaları (satış oluşturma, tahsilat kaydetme, iptal vb.) canlıya alındığında kullanılacak SÖZLEŞMEYİ önceden dokümante eder, böylece entegrasyonunuzu bu davranışa göre tasarlayabilirsiniz.

Planlanan Kullanım

Değişiklik yapan (yazma) bir isteğe Idempotency-Key header'ı ekleyeceksiniz:

curl -X POST https://otomovena.com/api/v1/collections \
  -H "Authorization: Bearer otv_live_xxxxx..." \
  -H "Idempotency-Key: 7c3f7e2a-1b4e-4b8a-9b0a-2f6e7c1d9a3b" \
  -H "Content-Type: application/json" \
  -d '{"sale_id": "...", "amount": 5000, "currency": "TRY"}'

Aynı Idempotency-Key ile ikinci kez gönderilen istek, işlemi TEKRAR uygulamaz — ilk isteğin sonucunu aynen döner.

Hangi Uç Noktalar Etkilenecek?

Özellikle finansal ve yıkıcı işlemler (Tahsilat oluşturma/ters çevirme, Satış oluşturma/iptal, Cüzdan yükleme talebi, Boost sipariş oluşturma) için zorunlu olması planlanmaktadır — bkz. API Referansı'ndaki "Yazma" ve "Yıkıcı" rozetli satırlar.

Şimdilik Ne Yapmalısınız?

Mevcut canlı uç noktalar (GET /api/v1/vehicles, GET /api/v1/customers, GET /api/v1/account) salt okunur olduğu için tekrar gönderim güvenlidir — herhangi bir idempotency önlemi almanıza gerek yoktur.