API pristup

WallaWhats izlaže iste operacije koje koristi nadzorna ploča kroz JSON HTTP API. Koristite ga za skriptiranje upravljanja pretplatama, povlačenje povijesti obavijesti u vlastite sustave ili integraciju upozorenja s internim alatima. Svaka plaćena razina uključuje API pristup — pogledajte Upravljaj planom za ograničenja ključeva po planu.

Korak 1 — Otvorite API ključevi

Iz bočne trake kliknite API ključevi (pod Pristupni ključevi).

Korak 2 — Stvorite ključ

1. Kliknite Stvori ključ.
2. Dajte ključu ime (npr. produkcijski-server, lokalni-dev). Ime je samo oznaka — ne utječe na dozvole.
3. Kliknite Stvori.

Puna vrijednost ključa prikazuje se jednom — odmah ju kopirajte u svog upravitelja tajni. WallaWhats pohranjuje samo hash plus kratak prefiks (bws_xxxxxxxx…), pa se ne može kasnije povratiti.

Tretirajte ključeve kao zaporke

Bilo tko s ključem može djelovati na vašem računu. Pohranjujte ključeve u upravitelju tajni, nikad ih ne committajte u git, i periodično rotirajte.

Korak 3 — Koristite ključ

Šaljite ključ u zaglavlju x-api-key u svakom zahtjevu:

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

Dostupne krajnje točke, tijela zahtjeva i oblici odgovora dokumentirani su u API Referenci.

Korak 4 — Rotacija ili opoziv

• Rotacija — stvorite novi ključ, postavite ga, zatim izbrišite stari. Po dizajnu nema gumba "rotiraj"; stvori-pa-izbriši čini prijelaz atomskim.
• Opozovi — kliknite Izbriši pored retka ključa. Ključ prestaje raditi trenutačno. Bilo koji zahtjevi u tijeku koji ga koriste vraćaju 401 Unauthorized.

Ograničenja plana

Plan	API ključevi
Free	1
Pro	1
Pro+	2
Business	5
Enterprise	20

Ako dosegnete ograničenje, Stvori ključ je onemogućeno — prvo izbrišite stari ključ ili nadogradite plan.

Što slijedi

Za sheme zahtjeva/odgovora i potpuni popis krajnjih točaka pogledajte API Referencu →.