Prístup k API

WallaWhats vystavuje rovnaké operácie, ktoré používa panel, cez JSON HTTP API. Použite ju na skriptovanie správy predplatných, sťahovanie histórie upozornení do vlastných systémov alebo integráciu upozornení s internými nástrojmi. Každý platený plán zahŕňa prístup k API — pozri Spravujte plán pre limity kľúčov na plán.

Krok 1 — Otvorte API kľúče

V bočnom paneli kliknite na API kľúče (pod Prístupové kľúče).

Krok 2 — Vytvorenie kľúča

1. Kliknite na Vytvoriť kľúč.
2. Dajte kľúču meno (napr. prod-server, lokalny-dev). Meno je iba štítok — neovplyvňuje oprávnenia.
3. Kliknite na Vytvoriť.

Plná hodnota kľúča sa zobrazí len raz — okamžite ju skopírujte do správcu tajomstiev. WallaWhats ukladá len hash plus krátky prefix (bws_xxxxxxxx…), takže sa nedá obnoviť neskôr.

Zaobchádzajte s kľúčmi ako s heslami

Ktokoľvek s kľúčom môže konať na vašom účte. Ukladajte kľúče v správcovi tajomstiev, nikdy ich necommitujte do gitu, a pravidelne rotujte.

Krok 3 — Použitie kľúča

Posielajte kľúč v hlavičke x-api-key pri každej žiadosti:

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

Dostupné endpointy, telá žiadostí a formy odpovedí sú dokumentované v API referencii.

Krok 4 — Rotácia alebo zrušenie

• Rotácia — vytvorte nový kľúč, nasaďte ho, potom zmažte starý. Tlačidlo "rotácia" neexistuje by design; vytvoriť-potom-zmazať robí prechod atomický.
• Zrušiť — kliknite na Zmazať vedľa riadku kľúča. Kľúč prestane fungovať okamžite. Akékoľvek prebiehajúce žiadosti používajúce ho vrátia 401 Unauthorized.

Limity plánu

Plán	API kľúče
Free	1
Pro	1
Pro+	2
Business	5
Enterprise	20

Ak dosiahnete limit, Vytvoriť kľúč je deaktivované — najprv zmažte starý kľúč alebo upgradujte plán.

Čo ďalej

Pre schémy žiadostí/odpovedí a kompletný zoznam endpointov pozrite API referenciu →