Rate limit ve hata kodları

3 dk okuma · API ve entegrasyonlar

Rate limit'ler API'nin kötüye kullanımını önler. Aşıldığında Retry-After başlığıyla HTTP 429 alırsınız.

Plana göre limitler

Skúšobná doba / Štandard: dakikada 60 istek Profi: dakikada 300 istek Business: dakikada 1000 istek Limit token başınadır, kullanıcı başına değildir (farklı kullanım durumları için birden fazla token'a sahip olabilirsiniz).

Hata kodları

- 401 Unauthorized: eksik veya geçersiz token - 403 Forbidden: token verilen eylem için yetkiye sahip değil (write uç noktasında read-only token) - 404 Not Found: kaynak mevcut değil - 429 Too Many Requests: rate limit aşıldı, Retry-After saniye bekleyin - 5xx: sunucu hatası, exponential backoff ile yeniden deneyin

En iyi uygulamalar

- Okuma için yanıtları önbelleğe alın (uptime verileri her saniye değişmez) - Mümkün olduğunda polling yerine webhook kullanın - Batch işlemlerinde istekler arasında gecikme kullanın