> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.eis.it/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.eis.it/_mcp/server.

# Errori API

> Guida agli errori delle API Hive basata sugli status HTTP e sulle risposte definite nel contratto OpenAPI.

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

| Status | Significato generale             | Indicazione                                                       |
| ------ | -------------------------------- | ----------------------------------------------------------------- |
| `400`  | Richiesta o parametri non validi | Correggi i dati inviati prima di riprovare.                       |
| `401`  | Credenziale API non valida       | Verifica `clientId` e `clientSecret`.                             |
| `404`  | Risorsa non trovata              | Controlla identificativi e parametri.                             |
| `500`  | Errore interno                   | Conserva il contesto tecnico e contatta l'assistenza se persiste. |

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.