Limiti di frequenza
I limiti valgono per singola chiave API, in finestre di 60 secondi.
| Chiave | Richieste ogni 60 secondi |
|---|---|
tl_live_… | 600 |
tl_test_… | 120 |
Intestazioni
RateLimit-Limit | richieste consentite nella finestra. |
RateLimit-Remaining | richieste rimaste nella finestra. |
RateLimit-Reset | secondi all'inizio della finestra successiva. |
RateLimit-Policy | la regola applicata, per esempio 600;w=60. |
Retry-After | solo con 429: secondi da attendere prima di riprovare. |
Limite superato
HTTP/1.1 429 Too Many Requests
RateLimit-Limit: 600
RateLimit-Remaining: 0
RateLimit-Reset: 23
RateLimit-Policy: 600;w=60
Retry-After: 23
{
"error": {
"code": "rate_limit_exceeded",
"message": "Troppe richieste. Attendi il tempo indicato in Retry-After.",
"doc_url": "https://docs.taplogic.it/it/errors#rate_limit_exceeded",
"request_id": "req_Qm3Xc81ZpRt0aBcYvWsK"
}
}Leggi RateLimit-Remaining e rallenta prima di arrivare a zero. Per sincronizzazioni grandi usa limit=100 e i webhook al posto delle letture periodiche.