API Rate Limit'leri ve Kotalar
Botonom REST API rate limit'leri, response header'ları ve otomatik kota aşımı yönetimi.
Rate limit'ler ve kotalar
Limitler API anahtarı bazında ve sabit 1 dakikalık time window'lar halinde uygulanır:
| Kapsam | Limit |
|---|---|
| Tüm standart endpoint'ler | 120 istek / dakika |
agents/command (ek kota) | 10 komut / dakika |
Agent komutları gerçek bir yapay zekâ turu yürüttüğü için daha sıkı bir güvenlik kotasına sahiptir. Kotanın aşılması durumunda API, error.code: RATE_LIMITED mesajı ve pencerenin sıfırlanmasına kalan süreyi belirten Retry-After header'ı ile birlikte 429 status code döndürür.
429 yanıtı aldığınızda isteklerinizi exponential backoff ile yeniden deneyin. Aynı Idempotency-Key ile yinelenen istekler komut kotanızdan düşmez.Response header'ları
Doğrulanmış her v1 API yanıtı aşağıdaki rate limit header'larını içerir:
X-RateLimit-Limit: 120
X-RateLimit-Remaining: 87
İstek hızınızı proaktif olarak ayarlamak için X-RateLimit-Remaining değerini izleyebilirsiniz.

