API access

Inilalantad ng WallaWhats ang parehong mga operasyon na ginagamit ng dashboard sa pamamagitan ng JSON HTTP API. Gamitin ito para mag-script ng subscription management, hilahin ang notification history sa sarili mong systems, o mag-integrate ng alerts sa internal tooling. Bawat bayad na tier ay may kasamang API access — tingnan ang Pamahalaan ang plan para sa mga limit ng key kada plan.

Hakbang 1 — Buksan ang API Keys

Mula sa sidebar, i-click ang API Keys (sa ilalim ng Access keys).

Hakbang 2 — Gumawa ng key

1. I-click ang Create key.
2. Bigyan ang key ng pangalan (hal. production-server, local-dev). Ang pangalan ay isang label lamang — hindi nito naaapektuhan ang mga permission.
3. I-click ang Create.

Ang buong halaga ng key ay ipinapakita isang beses — kopyahin agad ito sa iyong secret manager. Tanging hash plus maikling prefix (bws_xxxxxxxx…) lang ang iniimbak ng WallaWhats kaya hindi ito mababawi mamaya.

Tratuhin ang keys tulad ng mga password

Ang sinumang may key ay maaaring kumilos sa iyong account. Mag-imbak ng keys sa isang secret manager, huwag i-commit sa git, at i-rotate paminsan-minsan.

Hakbang 3 — Gamitin ang key

Ipadala ang key sa x-api-key header sa bawat request:

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

Ang available na endpoints, request bodies, at response shapes ay nadokumento sa API Reference.

Hakbang 4 — I-rotate o bawiin

• I-rotate — gumawa ng bagong key, i-deploy, pagkatapos ay tanggalin ang luma. Walang "rotate" button by design; create-then-delete ang gumagawang atomic ng cutover.
• Bawiin — i-click ang Delete sa tabi ng row ng key. Ang key ay agad na hihinto sa paggana. Anumang in-flight requests gamit ito ay magbabalik ng 401 Unauthorized.

Mga limit ng plan

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

Kung naabot mo ang limit, ang Create key ay disabled — magtanggal muna ng lumang key o mag-upgrade ng plan.

Susunod

Para sa request/response schemas at sa kumpletong listahan ng endpoint, tingnan ang API Reference →.