# Riferimento al codice di errore

> Ogni codice di errore restituito dall'API BroadNet, il suo significato e come gestirlo. Aggiornato ogni volta che vengono aggiunti nuovi codici.

- URL canonico: https://www.broadnet.me/it/developers/error-codes
- Lingua: it
- Ultimo aggiornamento: 2026-10-21
- Editore: BroadNet (https://www.broadnet.me)

L'API REST BroadNet segnala gli errori con un codice di stato HTTP standard e un corpo JSON chiamato ExceptionResponse, con cinque campi: status, error, message, errorCode e requestUri. La corrispondenza avviene prima sullo stato HTTP, poi su errorCode. Un'eccezione: un token Bearer mancante o non valido viene rifiutato prima, al gateway API, con un codice 401 il cui corpo contiene solo error e message.

## Codici di stato

400 indica un errore di convalida o un campo obbligatorio mancante: correggere la richiesta. 401 indica che il token Bearer è mancante o non valido, e 403 che non è consentito chiamare l'operazione: correggere il token. 500 indica un errore imprevisto del server e 502 indica che un provider a monte ha rifiutato la chiamata: riprovare con backoff esponenziale. I bind SMPP restituiscono invece i codici standard command_status SMPP.

## Esempi

### ExceptionResponse

```json
{
  "status": 400,
  "error": "Bad Request",
  "message": "…",
  "errorCode": "…",
  "requestUri": "/sms/sendSms"
}
```

### 401 Unauthorized (API gateway)

```json
{
  "error": "Unauthorized",
  "message": "Missing Authorization token"
}
```

## Correlati

- [Problema + errori JSON e standard di paginazione](https://www.broadnet.me/it/reference/api-errors-and-pagination)