Sınırlar ve kotalar
Bir anahtarla yapılan her isteğe iki sınır uygulanır: hız sınırı (dakikadaki istek sayısı, kısa bir ani artış payıyla) ve kuruluşun günlük kotası (planı). Anonim istekler, istemci adresi başına tek bir hız sınırını paylaşır.
Hız sınırları
| Uç nokta grubu | Anonim, adres başına | API anahtarıyla |
|---|---|---|
| Herkese açık veriler (firmalar, rehber, endeks, gereklilikler) | 300/dk, ani artış 60 | bunun 20 katı, anahtar başına |
| Fırsatlar | 300/dk, ani artış 60 | bunun 20 katı, anahtar başına |
| Arama | 120/dk, ani artış 30 | bunun 20 katı, anahtar başına |
/v1/org/... (kuruluş kayıtları) | kullanılamaz | 1200/dk, ani artış 600 |
MCP (/mcp) | 60/dk, ani artış 20 | bunun 20 katı, anahtar başına |
/oauth/token | adres ve istemci başına 30/dk, ani artış 10 | uygulanmaz |
| İş ortağı risk sinyalleri | uygulanmaz | anahtar başına 60/dk |
Bir sınıra ulaşıldığında API, 429 durum kodu, Retry-After (saniye) başlığı ve rate_limited koduyla yanıt verir. O kadar bekleyin, sonra devam edin. Birden çok çalışan (worker) aynı anahtarı paylaşıyorsa rastgele bir gecikme (jitter) ekleyin.
Günlük kotalar
Bir kuruluşun anahtarları ve OAuth belirteçleri, planına göre belirlenen tek bir günlük kotayı paylaşır (ücretsiz planda günde 10.000 istek). Kota gün boyunca eşit olarak dolar. Kota bittiğinde istekler 429, quota_exceeded kodu ve Retry-After alır.
Kullanım
İstekler anahtar ve gün başına sayılır. GET /v1/orgs/{org_id}/api-usage?month=YYYY-MM bir ayı anahtar ve OAuth istemcisi başına toplar (bir istemcinin bir saatlik belirteçleri birlikte sayılır) ve günlük kotanın yanında verir; GET /v1/orgs/{org_id}/api-keys/{key_id}/usage tek bir anahtarın günlerini verir. Bir plan API kullanımını ücretlendirdiğinde faturalar aynı sayımlardan oluşturulur.
İyi bir istemci olmak
- Okuduklarınızı önbelleğe alın. Firma sayfaları yavaş değişir; herkese açık bir yanıtın ne kadar süre güncel kalacağını
Cache-Controlsöyler. - Kuruluşunuzun olayları için yoklama (polling) yerine webhook'ları tercih edin.
429ve5xxyanıtlarını artan bekleme süreleriyle (backoff) yeniden deneyin; diğer4xxyanıtlarını isteği değiştirmeden yeniden denemeyin.