1 · Sorgente inglese
429 — Rate limit exceeded. You have sent too many requests in a given amount of time. Retry after the value (in seconds) of the Retry-After response header. Consider implementing exponential backoff with jitter.
403 — Forbidden. The API key is valid but lacks the required scope. Check the np_scope claim in your JWT, or regenerate the key from the dashboard.
2 · Traduzione italiana
429 — Limite di frequenza superato. Hai inviato troppe richieste in un dato intervallo di tempo. Riprova dopo il valore (in secondi) dell'header di risposta Retry-After. Valuta l'implementazione di un backoff esponenziale con jitter.
403 — Accesso negato. La chiave API è valida ma non ha l'ambito richiesto. Controlla il claim np_scope nel tuo JWT, oppure rigenera la chiave dalla dashboard.
3 · Decisioni terminologiche
| EN | IT | Perché |
|---|---|---|
| rate limit | limite di frequenza | Resa consolidata nella documentazione HTTP italiana; 'limite di velocità' è sbagliato (quella è speed), 'limite di tariffa' un falso amico. |
| Forbidden (403) | Accesso negato | Coincide con la reason phrase che gli sviluppatori italiani vedono già in browser e strumenti — coerenza con l'ecosistema sopra la fedeltà letterale. |
| scope | ambito | Terminologia OAuth2 come localizzata nelle linee guida AGID/PA; non 'scopo', che in italiano vuol dire 'purpose'. |
| exponential backoff | backoff esponenziale | Il nome della tecnica resta inglese (come 'retry'); descriverlo in italiano spezzerebbe la ricercabilità tra documenti e Stack Overflow. |