Skip to content

Доступ до API

WallaWhats надає ті самі операції, що й панель, через JSON HTTP API. Використовуйте для скриптування управління підписками, витягування історії сповіщень у ваші системи або інтеграції оповіщень з внутрішніми інструментами. Кожен платний тариф включає доступ до API — див. Керуйте планом для лімітів ключів на план.

Крок 1 — Відкрийте Ключі API

У бічній панелі натисніть Ключі API (під Ключі доступу).

Сторінка Ключі API з одним ключем за замовчуванням

Крок 2 — Створення ключа

  1. Натисніть Створити ключ.
  2. Дайте ключу ім'я (наприклад, prod-server, local-dev). Ім'я — просто мітка, не впливає на права.
  3. Натисніть Створити.

Повне значення ключа показується один раз — одразу скопіюйте його у свій менеджер секретів. WallaWhats зберігає тільки хеш і короткий префікс (bws_xxxxxxxx…), тож відновити його пізніше неможливо.

Ставтеся до ключів як до паролів

Будь-хто з ключем може діяти у вашому акаунті. Зберігайте ключі в менеджері секретів, ніколи не комітьте їх у git і періодично ротуйте.

Крок 3 — Використання ключа

Надсилайте ключ у заголовку x-api-key у кожному запиті:

bash
curl -H "x-api-key: bws_xxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  https://api.wallawhats.com/subscriptions

Доступні ендпоінти, тіла запитів і форми відповідей задокументовано у Довіднику API.

Крок 4 — Ротація або відкликання

  • Ротація — створіть новий ключ, розгорніть його, потім видаліть старий. Кнопки «ротувати» немає — by design; створити-потім-видалити робить перехід атомарним.
  • Відкликати — натисніть Видалити поряд із рядком ключа. Ключ перестає працювати миттєво. Будь-які активні запити, що його використовують, повернуть 401 Unauthorized.

Ліміти плану

ПланКлючі API
Free1
Pro1
Pro+2
Business5
Enterprise20

Якщо досягли ліміту, Створити ключ недоступне — спершу видаліть старий ключ або підвищте план.

Що далі

Для схем запитів/відповідей і повного списку ендпоінтів див. Довідник API →

WallaWhats Documentation