# Autenticarsi tramite l'API BroadNet

> Ogni richiesta REST include un header Authorization: Bearer con il token di accesso del tuo account BroadNet. Un token mancante o non valido restituisce 401 con un corpo di errore JSON. L'API HTTP legacy (/websmpp) riceve le credenziali come parametri ed è mantenuta solo per le integrazioni esistenti dell'era SMPP.

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

Ogni richiesta API REST BroadNet include il tuo token di accesso nell'intestazione Authorization: Bearer. Il token viene emesso per ogni account e proviene dal tuo account BroadNet; l'API non prevede alcuna chiamata che scambi nome utente e password con un token. Un token mancante o non valido viene rifiutato dal gateway API con HTTP 401 e un corpo JSON composto da due campi: error e message.

> **Non incorporare mai il token lato client** Il token di accesso concede i diritti di invio sul tuo account. Conservalo in una variabile d'ambiente o in un gestore di segreti, al di fuori del controllo di versione, delle app per dispositivi mobili e del codice del browser, e chiama sempre l'API tramite HTTPS.

## Credenziali legacy /websmpp

L'API HTTP legacy sotto /websmpp, mantenuta per le integrazioni dell'era SMPP, accetta le credenziali come parametri di richiesta (nome utente e password o chiave di accesso) anziché un token Bearer. Utilizzatela solo se ne avete già bisogno; le nuove integrazioni dovrebbero utilizzare l'API REST con token Bearer.

## Esempi

### authenticated request

```bash
curl -X POST https://api.broadnet.me/sms/identify \
  -H "Authorization: Bearer $BROADNET_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "message": "Hello from BroadNet" }'
```

Stessa intestazione su ogni endpoint e su ogni canale.

### 401 Unauthorized

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

## Correlati

- [Standard di autenticazione e firma API](https://www.broadnet.me/it/reference/api-authentication-and-signing)
- [Guida rapida](https://www.broadnet.me/it/developers/quickstart)