bulksmsapi
Отримати API ключ

Початок роботи

Аутентифікація за допомогою API ключів

Переглянути як MarkdownСпецифікація OpenAPI

Кожен endpoint, окрім двох endpointів ціноутворення, потребує API ключа в заголовку Authorization.

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

Створення ключів

  • Ключі створюються на сторінці API ключів у консолі. Сторінка відкривається після першого поповнення балансу.
  • Обліковий запис може містити 10 активних ключів. Надайте кожній програмі або середовищу свій ключ і назву, щоб один можна було замінити, не торкаючись інших.
  • Ключ, це bsa_live_, за яким йдуть 32 літери та цифри. Він показується один раз під час створення; ми зберігаємо лише хеш з ключем, тому втрачений ключ не можна показати знову. Створіть новий замість цього.
  • Список показує перші символи, останні чотири, коли ключ був створений і коли востаннє використовувався.

Зміна та відкликання

Щоб змінити ключ без простою: створіть другий ключ, розгорніть його, перевірте час останнього використання в консолі, а потім відкликайте старий ключ. Відкликаний ключ відповідає 401 unauthorized на кожен наступний запит.

Збереження ключів у безпеці

  • Викликайте API з вашого сервера, ніколи з браузера чи мобільного додатка: будь-хто з ключем може надсилати повідомлення з вашого балансу.
  • Зберігайте ключі у змінних середовища або менеджері секретів, а не в системі контролю версій.
  • Кожен ключ має свій лічильник обмеження швидкості, тому зайнятий працівник не уповільнює другий ключ, який використовується в іншому місці.

Помилки

401 UnauthorizedJSON
{
  "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"
  }
}
ПопередняШвидкий стартДаліПовідомлення
Аутентифікація за допомогою API ключів | BulkSMSAPI Docs