Uwierzytelnianie za pomocą kluczy API

Każdy punkt końcowy, z wyjątkiem dwóch punktów końcowych cenowych, wymaga klucza API w nagłówku Authorization.

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

Tworzenie kluczy

• Klucze są tworzone na stronie kluczy API w konsoli. Strona otwiera się po pierwszym doładowaniu salda.
• Konto może posiadać 10 aktywnych kluczy. Nadaj każdej aplikacji lub środowisku własny klucz i nazwę, aby jeden można było zastąpić bez ingerencji w inne.
• Klucz to bsa_live_ po którym następuje 32 litery i cyfry. Jest wyświetlany tylko raz, gdy jest tworzony; przechowujemy tylko zahashowaną wersję klucza, więc utracony klucz nie może być ponownie wyświetlony. Zamiast tego utwórz nowy.
• Lista pokazuje pierwsze znaki, ostatnie cztery, kiedy klucz został utworzony i kiedy był ostatnio używany.

Rotacja i odwoływanie

Aby rotować klucz bez przestojów: utwórz drugi klucz, wdroż go, sprawdź czas ostatniego użycia w konsoli, a następnie odwołaj stary klucz. Odwołany klucz odpowiada 401 unauthorized od następnego żądania.

Bezpieczne przechowywanie kluczy

• Wywołuj API z serwera, nigdy z przeglądarki lub aplikacji mobilnej: każdy, kto ma klucz, może wysyłać wiadomości z Twojego salda.
• Przechowuj klucze w zmiennych środowiskowych lub menedżerze tajemnic, a nie w kontroli źródła.
• Każdy klucz ma własny licznik limitów szybkości, więc zajęty pracownik nie spowalnia drugiego klucza używanego gdzie indziej.

Błędy

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