Hız sınırları

Her API anahtarının, planınızdan türetilen sürekli bir saniyede istek sınırı vardır (Free 1 req/s → Max 60 req/s — bkz. Fiyatlandırma). Sınırlar bir token bucket ile uygulanır: dakika başına kapasitenize kadar olan patlamalara izin verilir, ardından istekler sürekli orana yumuşatılır.

Sınırlandırıldığınızda

{ "error": "rate_limited", "retry_after_ms": 850 }

HTTP 429, error: "rate_limited".
retry_after_ms yeniden denemeden önce beklemeniz gereken minimum süreyi söyler.
Her yanıttaki x-ratelimit-remaining başlığı bu dakika kaç isteğin kaldığını bildirir.

Eşzamanlılık

Saniye başına oranın ötesinde, devam eden isteklerde bir üst sınır vardır. Aynı anda çok sayıda istek gönderirseniz şunları görebilirsiniz:

409 request_in_progress — aynı idempotent istek zaten çalışıyor.
503 too_many_concurrent_requests — devam eden çok fazla eşzamanlı istek; geri çekilin ve yeniden deneyin.

Sınırları yönetme

retry_after_ms değerine uyun; aksi takdirde jitter ile üstel geri çekilme kullanın.
İstemci tarafında planınızın oranıyla eşleşen bir eşzamanlılık üst sınırı tutun.
Resmi SDK’ler 429/503 hatalarını otomatik olarak yeniden dener.