API pubblica

Diagnosticare 401, 403, 422 e 429

401 significa che la chiave non è stata accettata affatto. 403 significa che è stata accettata ma l’operazione non è consentita. 422 significa che la richiesta è stata capita e il payload era sbagliato. 429 significa che hai superato il rate limit e conviene attendere invece di riprovare subito.

Verificato il 20 agosto 2026

Passaggi

1. Su 401 verifica che la chiave esista, non sia scaduta e venga inviata nell’header che pensi — di solito la causa è un incollaggio troncato.
2. Su 403 leggi il code: scope insufficiente, un indirizzo fuori dalla allow-list, o una chiave di un altro workspace. Riconnettersi non aiuta; deve cambiare il permesso.
3. Su 422 leggi il campo che la risposta nomina e correggi il payload.
4. Su 429 rispetta gli header di rate limit e attendi. Riprovare subito peggiora le cose.
5. Conserva il requestId della risposta — è ciò che permette all’assistenza di trovare la tua chiamata esatta.

Come verificare il risultato

La stessa richiesta riesce dopo la correzione, e la risposta porta uno stato 2xx con l’oggetto atteso.

Che cosa va storto di solito

• Trattare un 403 come chiave sbagliata e riemetterla, il che non cambia nulla.
• Riprovare un 429 in un ciclo stretto.
• Mandare all’assistenza la chiave invece dell’id della richiesta.