Достъп до API

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

Стъпка 1 — Отворете API ключове

От страничната лента щракнете API ключове (под Ключове за достъп).

Стъпка 2 — Създайте ключ

1. Щракнете Създай ключ.
2. Дайте на ключа име (напр. production-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 — Ротация или анулиране

• Ротация — създайте нов ключ, разгърнете го, след това изтрийте стария. Няма бутон "ротирай" по дизайн; създай-после-изтрий прави прехода атомичен.
• Анулирай — щракнете Изтрий до реда на ключа. Ключът спира да работи мигновено. Всички текущи заявки, използващи го, връщат 401 Unauthorized.

Ограничения на плана

План	API ключове
Free	1
Pro	1
Pro+	2
Business	5
Enterprise	20

Ако достигнете лимита, Създай ключ е деактивирано — първо изтрийте стар ключ или надстройте плана.

Какво следва

За схеми на заявка/отговор и пълен списък с крайни точки вижте API Справочник →.