Limiti

Frequenza massima, pesi per endpoint, gestione del 429.

I valori

• 4 richieste al secondo per chiave, con un burst massimo di 40 gettoni;
• gli endpoint hanno un peso: una lettura semplice costa 1 gettone, un elenco 2, i calcoli e le scritture importanti 5–10 (il peso è indicato nella reference, endpoint per endpoint);
• al massimo 2 richieste in volo per chiave: la terza contemporanea riceve subito 429.

Leggere i limiti nelle risposte

X-RateLimit-Limite: 40
X-RateLimit-Rimanenti: 31

Superato il limite la risposta è 429 con l'attesa consigliata:

HTTP/1.1 429 Too Many Requests
Retry-After: 2

{ "errore": { "codice": "troppe_richieste", "messaggio": "…" } }

Gestione del 429

Alla risposta 429 il client attende i secondi indicati in Retry-After e ritenta. In pseudocodice:

per ogni richiesta:
    risposta = chiama()
    se risposta.status == 429:
        aspetta(risposta.header['Retry-After'] secondi)
        riprova (fino a 3 volte)