Přístup k API

WallaWhats vystavuje stejné operace, které používá panel, přes JSON HTTP API. Použijte ji pro skriptování správy předplatných, stahování historie notifikací do vlastních systémů nebo integraci upozornění s interními nástroji. Každý placený tarif zahrnuje přístup k API — viz Spravujte tarif pro limity klíčů na tarif.

Krok 1 — Otevřete API klíče

V postranním panelu klikněte na API klíče (pod Přístupové klíče).

Krok 2 — Vytvoření klíče

1. Klikněte na Vytvořit klíč.
2. Dejte klíči jméno (např. produkcni-server, lokalni-dev). Jméno je jen štítek — neovlivňuje oprávnění.
3. Klikněte na Vytvořit.

Plná hodnota klíče se zobrazí jen jednou — okamžitě ji zkopírujte do svého správce tajemství. WallaWhats ukládá jen hash plus krátký prefix (bws_xxxxxxxx…), takže ji nelze později obnovit.

Zacházejte s klíči jako s hesly

Kdokoli s klíčem může jednat na vašem účtu. Ukládejte klíče do správce tajemství, nikdy je necommitujte do gitu a pravidelně rotujte.

Krok 3 — Použití klíče

Posílejte klíč v hlavičce x-api-key při každém požadavku:

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

Dostupné endpointy, těla požadavků a formy odpovědí jsou dokumentovány v API referenci.

Krok 4 — Rotace nebo zrušení

• Rotace — vytvořte nový klíč, nasaďte ho, pak smažte starý. Tlačítko "rotace" neexistuje by design; vytvořit-pak-smazat dělá přechod atomický.
• Zrušit — klikněte na Smazat vedle řádku klíče. Klíč přestane fungovat okamžitě. Jakékoli probíhající požadavky používající ho vrátí 401 Unauthorized.

Limity tarifu

Tarif	API klíče
Free	1
Pro	1
Pro+	2
Business	5
Enterprise	20

Pokud dosáhnete limitu, Vytvořit klíč je deaktivováno — nejprve smažte starý klíč nebo upgradujte tarif.

Co dál

Pro schémata požadavků/odpovědí a kompletní seznam endpointů viz API referenci →