API dostop

WallaWhats izpostavlja iste operacije, ki jih uporablja nadzorna plošča, prek JSON HTTP API-ja. Uporabite ga za skriptiranje upravljanja naročnin, vleko zgodovine obvestil v lastne sisteme ali integracijo opozoril z notranjim orodjem. Vsak plačani nivo vključuje API dostop — glejte Upravljanje naročnine za omejitve ključev po naročnini.

Korak 1 — Odprite API ključi

V stranski vrstici kliknite API ključi (pod Dostopni ključi).

Korak 2 — Ustvarite ključ

1. Kliknite Ustvari ključ.
2. Ključu dajte ime (npr. produkcijski-strežnik, lokalni-dev). Ime je le oznaka — ne vpliva na pravice.
3. Kliknite Ustvari.

Polna vrednost ključa se prikaže enkrat — takoj jo kopirajte v upravitelja skrivnosti. WallaWhats shrani samo hash plus kratko predpono (bws_xxxxxxxx…), tako da je kasneje ni mogoče obnoviti.

Obravnavajte ključe kot gesla

Kdor koli s ključem lahko deluje na vašem računu. Shranite ključe v upravitelju skrivnosti, nikoli jih ne commitajte v git, in jih periodično rotirajte.

Korak 3 — Uporabite ključ

Pošljite ključ v glavi x-api-key v vsakem zahtevku:

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

Razpoložljive končne točke, telesa zahtev in oblike odzivov so dokumentirani v API Referenci.

Korak 4 — Rotacija ali preklic

• Rotacija — ustvarite svež ključ, namestite ga, nato izbrišite starega. Gumba "rotiraj" po zasnovi ni; ustvari-nato-izbriši naredi prehod atomski.
• Prekličite — kliknite Izbriši poleg vrstice ključa. Ključ takoj preneha delovati. Kakršne koli tekoče zahteve, ki ga uporabljajo, vrnejo 401 Unauthorized.

Omejitve naročnine

Naročnina	API ključi
Free	1
Pro	1
Pro+	2
Business	5
Enterprise	20

Če dosežete omejitev, je Ustvari ključ onemogočeno — najprej izbrišite star ključ ali nadgradite naročnino.

Kaj sledi

Za sheme zahteva/odgovora in popoln seznam končnih točk glejte API Referenco →.