Доступ к API

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

Шаг 1 — Откройте Ключи API

В боковой панели нажмите Ключи API (под Ключи доступа).

Шаг 2 — Создание ключа

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

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

Относитесь к ключам как к паролям

Любой обладатель ключа может действовать в вашем аккаунте. Храните ключи в менеджере секретов, не коммитьте их в git и периодически ротируйте.

Шаг 3 — Используйте ключ

Отправляйте ключ в заголовке x-api-key при каждом запросе:

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

Доступные эндпоинты, тела запросов и формы ответов задокументированы в Справочнике API.

Шаг 4 — Ротация или отзыв

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

Лимиты плана

План	Ключи API
Free	1
Pro	1
Pro+	2
Business	5
Enterprise	20

Если достигли лимита, Создать ключ недоступно — сначала удалите старый ключ или повысьте план.

Что дальше

Для схем запросов/ответов и полного списка эндпоинтов см. Справочник API →