# Autenticazione

Ogni richiesta alla API REST porta la tua chiave in un’intestazione. Una chiave per account, disponibile dopo la prima ricarica e revocabile dalla dashboard in qualsiasi momento.

## Come mi autentico alla API di SMS Nitro?

Invia la chiave nell’intestazione X-Api-Key (funziona anche Authorization: Bearer <chiave>) in ogni richiesta a https://smsnitro.com/api/v1. Una chiave assente, errata o revocata restituisce 401 con il dettaglio Invalid or revoked API key.

## Come generare la chiave

- L’accesso alla API si attiva dopo la prima ricarica confermata.
- Apri Dashboard > API e genera la chiave. Viene mostrata una sola volta, quindi salvala subito in un gestore di segreti.
- Ogni account ha una chiave attiva. Generarne una nuova revoca subito la precedente.

## Come inviare la chiave

Entrambi i formati di intestazione valgono su tutti gli endpoint. Scegline uno e usalo sempre.

| Intestazione | Esempio |
|---|---|
| X-Api-Key | X-Api-Key: <la tua chiave> (consigliato) |
| Authorization | Authorization: Bearer <la tua chiave> |

**X-Api-Key**

```bash
curl https://smsnitro.com/api/v1/balance \
  -H "X-Api-Key: $SMSNITRO_API_KEY"
```

**Bearer**

```bash
curl https://smsnitro.com/api/v1/balance \
  -H "Authorization: Bearer $SMSNITRO_API_KEY"
```

## Come proteggere la chiave

La chiave può spendere il tuo saldo: trattala come una password.

- Tienila in una variabile d’ambiente o in un gestore di segreti, mai nel codice sorgente.
- Chiama la API solo dal tuo server. Non inserirla mai nel browser, in un’app mobile o in un programma desktop.
- Non incollarla in ticket, log o screenshot.
- Se viene esposta, generane una nuova dalla dashboard: la vecchia smette subito di funzionare.

**Variabile d’ambiente**

```bash
# .env (never commit this file)
SMSNITRO_API_KEY=your-key-from-the-dashboard
```

## FAQ

**Posso avere più chiavi?** No. Ogni account ha una chiave attiva; generarne un’altra sostituisce quella attuale.

**La chiave scade?** No. Resta valida finché non ne generi una nuova dalla dashboard.

Fonte: https://smsnitro.com/it/sviluppatori/autenticazione