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> |
curl https://smsnitro.com/api/v1/balance \
-H "X-Api-Key: $SMSNITRO_API_KEY"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.
# .env (never commit this file)
SMSNITRO_API_KEY=your-key-from-the-dashboardDomande frequenti
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.