Authentifizierung mit API-Schlüsseln

Jeder Endpunkt außer den beiden Preis-Endpunkten benötigt einen API-Schlüssel im Authorization-Header.

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

Schlüssel erstellen

• Schlüssel werden auf der API-Schlüssel-Seite der Konsole erstellt. Die Seite öffnet sich, nachdem das erste Guthaben aufgeladen wurde.
• Ein Konto kann 10 aktive Schlüssel halten. Geben Sie jeder App oder Umgebung ihren eigenen Schlüssel und Namen, damit einer ersetzt werden kann, ohne die anderen zu beeinträchtigen.
• Ein Schlüssel besteht aus bsa_live_ gefolgt von 32 Buchstaben und Ziffern. Er wird einmal angezeigt, wenn er erstellt wird; wir speichern nur einen gehashten Wert, sodass ein verlorener Schlüssel nicht erneut angezeigt werden kann. Erstellen Sie stattdessen einen neuen.
• Die Liste zeigt die ersten Zeichen, die letzten vier, wann der Schlüssel erstellt wurde und wann er zuletzt verwendet wurde.

Rotieren und Widerrufen

Um einen Schlüssel ohne Ausfallzeit zu rotieren: Erstellen Sie einen zweiten Schlüssel, stellen Sie ihn bereit, überprüfen Sie die letzte Nutzungszeit in der Konsole und widerrufen Sie dann den alten Schlüssel. Ein widerrufener Schlüssel antwortet ab der nächsten Anfrage mit 401 unauthorized.

Schlüssel sicher aufbewahren

• Rufen Sie die API von Ihrem Server aus auf, niemals von einem Browser oder einer mobilen App: Jeder mit dem Schlüssel kann Nachrichten von Ihrem Guthaben senden.
• Bewahren Sie Schlüssel in Umgebungsvariablen oder einem Secret Manager auf, nicht in der Versionskontrolle.
• Jeder Schlüssel hat seinen eigenen Rate-Limit-Zähler, sodass ein ausgelasteter Worker einen zweiten Schlüssel, der anderswo verwendet wird, nicht verlangsamt.

Fehler

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