Authentification avec les clés API

Chaque endpoint, sauf les deux endpoints de tarification, nécessite une clé API dans l'en-tête Authorization.

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

Création de clés

• Les clés sont créées sur la page des clés API de la console. La page s'ouvre après la première recharge ajoutée au solde.
• Un compte peut contenir 10 clés actives. Donnez à chaque application ou environnement sa propre clé et son nom, afin qu'une clé puisse être remplacée sans toucher aux autres.
• Une clé commence par bsa_live_ suivi de 32 lettres et chiffres. Elle n'est affichée qu'une seule fois, lors de sa création ; nous conservons uniquement un hash de la clé, donc une clé perdue ne peut pas être réaffichée. Créez-en une nouvelle à la place.
• La liste affiche les premiers caractères, les quatre derniers, quand la clé a été créée et quand elle a été utilisée pour la dernière fois.

Rotation et révocation

Pour faire tourner une clé sans interruption : créez une deuxième clé, déployez-la, vérifiez son heure d'utilisation dans la console, puis révoquez l'ancienne clé. Une clé révoquée répond 401 unauthorized à partir de la prochaine requête.

Sécurisation des clés

• Appelez l'API depuis votre serveur, jamais depuis un navigateur ou une application mobile : toute personne ayant la clé peut envoyer des messages depuis votre solde.
• Conservez les clés dans des variables d'environnement ou un gestionnaire de secrets, pas dans le contrôle de source.
• Chaque clé a son propre compteur de limite de débit, donc un worker occupé ne ralentit pas une deuxième clé utilisée ailleurs.

Erreurs

{
  "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"
  }
}