Errori e idempotenza

Le integrazioni robuste gestiscono errori e tentativi. Ogni risposta non-2xx utilizza un unico envelope di errore coerente con un codice, un messaggio e un link alla documentazione, in modo da poter gestire i fallimenti in modo programmatico. Quelli comuni: 401 auth, 402 crediti insufficienti, 429 limite di frequenza (ritira con Retry-After). E per sicurezza, l'API supporta l'idempotenza in modo che una richiesta ritentata non addebiti o agisca due volte. Costruisci con fiducia i tentativi. Errori prevedibili e tentativi sicuri - di livello di produzione.