Autenticazione con chiavi API

Ogni endpoint, tranne i due endpoint di pricing, richiede una chiave API nell'intestazione Authorization.

POST /v1/messages HTTP/1.1
Host: bulksmsapi.cc
Authorization: Bearer bsa_live_7QzX2mW9kR4tB8nV1cJ6yP3sH5dL0aFe
Content-Type: application/json

Creazione delle chiavi

• Le chiavi vengono create nella pagina delle chiavi API della console. La pagina si apre dopo che la prima ricarica viene aggiunta al saldo.
• Un account può contenere 10 chiavi attive. Assegna a ogni app o ambiente la propria chiave e nome, in modo che una possa essere sostituita senza toccare le altre.
• Una chiave è bsa_live_ seguito da 32 lettere e cifre. Viene mostrata una volta, quando viene creata; conserviamo solo un hash crittografato, quindi una chiave persa non può essere mostrata di nuovo. Crea invece una nuova chiave.
• L'elenco mostra i primi caratteri, gli ultimi quattro, quando la chiave è stata creata e quando è stata utilizzata l'ultima volta.

Rotazione e revoca

Per ruotare una chiave senza tempi di inattività: crea una seconda chiave, distribuiscila, controlla l'ultimo utilizzo nella console, quindi revoca la vecchia chiave. Una chiave revocata risponde 401 unauthorized dalla richiesta successiva.

Mantenere le chiavi al sicuro

• Chiama l'API dal tuo server, mai da un browser o un'app mobile: chiunque abbia la chiave può inviare messaggi dal tuo saldo.
• Mantieni le chiavi in variabili d'ambiente o in un gestore di segreti, non nel controllo del codice sorgente.
• Ogni chiave ha il proprio contatore di limite di frequenza, quindi un worker occupato non rallenta una seconda chiave utilizzata altrove.

Errori

{
  "error": {
    "code": "unauthorized",
    "message": "Send your API key as Authorization: Bearer bsa_live_... Keys are created in the console under API keys.",
    "doc_url": "https://bulksmsapi.cc/en/docs/errors#unauthorized"
  }
}