Dostęp do API

WallaWhats udostępnia te same operacje, których używa panel, poprzez JSON HTTP API. Użyj go do skryptowania zarządzania subskrypcjami, ściągania historii powiadomień do własnych systemów lub integrowania alertów z wewnętrznym oprzyrządowaniem. Każdy płatny plan obejmuje dostęp do API — zobacz Zarządzaj planem dla limitów kluczy na plan.

Krok 1 — Otwórz Klucze API

W pasku bocznym kliknij Klucze API (pod Klucze dostępu).

Krok 2 — Utwórz klucz

1. Kliknij Utwórz klucz.
2. Nadaj kluczowi nazwę (np. serwer-produkcyjny, lokalny-dev). Nazwa to tylko etykieta — nie wpływa na uprawnienia.
3. Kliknij Utwórz.

Pełna wartość klucza jest pokazywana raz — skopiuj go natychmiast do swojego managera sekretów. WallaWhats przechowuje tylko hash plus krótki prefiks (bws_xxxxxxxx…), więc nie można go odzyskać później.

Traktuj klucze jak hasła

Każdy z kluczem może działać na twoim koncie. Przechowuj klucze w managerze sekretów, nigdy nie commituj ich do git, i rotuj okresowo.

Krok 3 — Użyj klucza

Wyślij klucz w nagłówku x-api-key przy każdym żądaniu:

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

Dostępne endpointy, ciała żądań i kształty odpowiedzi są udokumentowane w Referencji API.

Krok 4 — Rotacja lub odwołanie

• Rotacja — utwórz nowy klucz, wdroż go, a potem usuń stary. Nie ma przycisku "rotuj" by design; utwórz-potem-usuń sprawia, że przełączenie jest atomowe.
• Odwołaj — kliknij Usuń obok wiersza klucza. Klucz przestaje działać natychmiast. Wszystkie trwające żądania używające go zwrócą 401 Unauthorized.

Limity planu

Plan	Klucze API
Free	1
Pro	1
Pro+	2
Business	5
Enterprise	20

Jeśli osiągniesz limit, Utwórz klucz jest wyłączony — najpierw usuń stary klucz lub zaktualizuj plan.

Co dalej

Dla schematów żądań/odpowiedzi i pełnej listy endpointów, zobacz Referencję API →