Errori API
Gestisci gli errori dichiarati da ogni operazione
Le risposte di errore sono definite per singolo endpoint. Consulta sempre la relativa operazione nella reference: il contratto non stabilisce un unico payload di errore condiviso da tutte le API.
Status presenti nel contratto
Alcune operazioni dichiarano status ulteriori o restituiscono dettagli nel body. Non presumere che formato e contenuto siano uguali tra moduli diversi.
Diagnostica
Quando segnali un problema, includi timestamp, ambiente, metodo HTTP, path e status ricevuto. Anonimizza il payload e non condividere API key, access token o dati personali.
Esegui retry automatici soltanto quando conosci l’idempotenza dell’operazione e puoi escludere che una scrittura sia già stata applicata.