Hız sınırı ve idempotency

Hız sınırı

Her API anahtarının planınızla belirlenen dakikalık istek bütçesi vardır (varsayılan 120/dk). Her yanıt şu başlıkları taşır:

Başlık	Anlamı
X-RateLimit-Limit	Dakikada izin verilen istek
X-RateLimit-Remaining	Bu dakikada kalan istek
X-RateLimit-Reset	Pencerenin sıfırlanmasına kalan saniye

Bütçe bitince API 429 ve Retry-After başlığı döner:

{ "errors": [ { "code": "rate_limit_exceeded", "message": "Rate limit of 120 requests per minute exceeded. Retry after 23 seconds." } ] }

Retry-After kadar bekleyip yeniden deneyin. Sürekli sorgulamak yerine webhook kullanın.

Idempotency

Ağ hatası, bir POST'un başarılı olup olmadığını belirsiz bırakabilir. POST, PUT ve PATCH isteklerinde Idempotency-Key başlığı gönderin (128 karaktere kadar benzersiz bir metin; UUID ya da kendi kayıt numaranız):

Idempotency-Key: siparis-10042-acildi

• İlk istek normal işlenir, yanıtı 24 saat saklanır.
• Aynı anahtar ve aynı istek ile tekrar denendiğinde saklanan yanıt Idempotent-Replayed: true başlığıyla döner.
• Aynı anahtar farklı gövdeyle gelirse 422 (idempotency_key_reused) döner.

Anahtarlar, gönderen API anahtarına özeldir.