Rate limit

Sofia API conta le richieste in tre finestre: 15 minuti, 24 ore e 30 giorni.

Token	15 minuti	24 ore	30 giorni
Chiave personale (per account)	150	1.000	10.000
Client OAuth	100	500	15.000
Client OAuth, per persona autorizzata (fino a 1.000)	+10	+25	+100

Header

Ogni risposta ti dice cosa resta, nel formato IETF:

http

RateLimit: "15m";r=144;t=43, "24h";r=994;t=13543, "30d";r=9994;t=13543
RateLimit-Policy: "15m";q=150;w=900, "24h";q=1000;w=86400, "30d";q=10000;w=2592000

r è il numero di richieste rimaste, t i secondi prima del reset della finestra, q la quota e w la finestra in secondi.

Quando una finestra è piena

La risposta è 429 rate_limit_exceeded, con un header Retry-After e la finestra esaurita in details. Attendi quel tempo prima di riprovare.

Usare l'API in modo efficiente

Registra un webhook invece di interrogare di continuo una pubblicazione.
Usa limit fino a 100 per leggere le liste in meno pagine.
Metti in cache ciò che cambia raramente: piattaforme, attività, account collegati.