Rate limit
I rate limit mantengono prevedibili le prestazioni del tenant. Vengono applicati per chiave API su una finestra fissa di 60 secondi.
Livelli
| Livello | Richieste / minuto |
|---|---|
standard (predefinito) | 120 |
elevated | 600 |
Il livello della tua chiave e il budget attuale sono riportati da GET /v1/auth/context (rate_limit_tier) e GET /v1/usage (rate_limit.limit_per_minute e rate_limit.remaining_per_minute). Leggi sempre i valori in tempo reale invece di codificarli in modo fisso.
Quando superi il limite
Le richieste oltre il limite restituiscono 429 con code: "RATE_LIMITED". Applica un backoff e ritenta dopo il reset della finestra.
Progettare entro i limiti
- Memorizza nella cache i dati di riferimento e preferisci sincronizzazioni incrementali al polling dell'intera tabella.
- Usa i webhook per gli aggiornamenti basati sugli eventi invece del polling.
- Applica un backoff su
429ed evita tempeste di ritentativi paralleli dopo guasti transitori. - Combina i filtri (
search,status,module) per recuperare meno dati.