Authentication
Версія API 1.0
Усі запити до API BSG повинні бути автентифіковані за допомогою персонального ключа API — Test або Live. Кожен запит містить заголовок X-API-KEY з вашим ключем API. Тестовий ключ API має префікс test_; боевий ключ API має префікс live_. Тестовий ключ API призначений для налагодження системи — всі запити з тестовим ключем повертають випадкову інформацію.
Переглядати й керувати ключами API можна на вкладці «SMPP/API Password» розділу Integrations & API у вашому особистому кабінеті.
Ваш персональний ключ API потрібно вказувати в заголовку HTTP X-API-KEY кожного запиту.
Версія API 2.0
Процес авторизації можливий за наявності токена, яким мають бути підписані всі наступні запити до API.
Токен передається в заголовку кожного запиту, окрім самого запиту на отримання токена, де він не потрібен:
"Authorization": "Bearer: {token}"
Щоб отримати токен, потрібно надіслати запит:
| POST https://one-api.bsg.world/api/auth/login |
Request Parameters
| Parameter | Required | Type | Description |
|---|---|---|---|
| api_key | Yes | string | Персональний ключ API. |
Request sample
{
"api_key": "live_qlTEagQz1StNSbjlXM8k"
}
Response Parameters
| Parameter | Type | Description |
|---|---|---|
| bearer | string | Токен для авторизації запитів до API. |
якщо запит виконано успішно, ви отримаєте відповідь:
{
"bearer": "string"
}
Щоб оновити JWT-токен, потрібно надіслати запит:
| POST https://one-api.bsg.world/api/auth/refresh |
якщо запит виконано успішно, ви отримаєте відповідь:
{
"bearer": "string"
}
Зацікавлені у спеціальній пропозиції?
Готові розширювати можливості?
Давайте обговоримо.
Корисні Матеріали
![WhatsApp Business API: повний гайд — налаштування, ціни, сценарії [2026]](/assets/img/blog/whatsapp-business-api-setup-pricing-use-cases-guide_avatar.jpg){kind=avatar}
WhatsApp Business API у 2026 — кроки налаштування, нова модель тарифікації за повідомлення та перевірені сценарії використання за галузями.
Що таке CPaaS? Хмарний API-шар, що додає SMS, WhatsApp, голос та OTP у ваші застосунки — як це працює і чому це краще за стек із кількох вендорів.
Чому один комунікаційний API для SMS, WhatsApp, Viber та RCS кращий за пʼять окремих інтеграцій — каскадний fallback, єдині звіти.