Limiti di frequenza e cache

Quante richieste puoi inviare, gli header che te lo indicano e cosa mettere in cache.

120 richieste al minuto

Ogni indirizzo può inviare 120 richieste al minuto all’API pubblica. Il conteggio riparte all’inizio di ogni minuto dell’orologio; RateLimit-Reset ti dice quanti secondi mancano.

Header che mostrano a che punto sei

Ogni risposta include RateLimit-Limit, quante richieste consente la finestra; RateLimit-Remaining, quante ne restano; e RateLimit-Reset, i secondi che mancano all'inizio della nuova finestra.

HTTP

RateLimit-Limit: 120
RateLimit-Remaining: 116
RateLimit-Reset: 20

Quando superi il limite

Una richiesta oltre il limite risponde 429 rate_limited con un header Retry-After in secondi. Attendi quel tempo prima della richiesta successiva; inviarne altre nel frattempo non accorcia l'attesa.

HTTP

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

{
  "statusCode": 429,
  "code": "rate_limited",
  "message": "Too many requests. Wait and try again."
}

Conserva una copia

I dati del catalogo cambiano al massimo qualche volta al giorno. Salva le risposte che usi e aggiornale a intervalli regolari invece di chiederle di nuovo per ogni visitatore. Alcune risposte includono un header Cache-Control che indica per quanto tempo restano aggiornate.