API-hozzáférés

A WallaWhats ugyanazokat a műveleteket teszi elérhetővé JSON HTTP API-n keresztül, mint amit a vezérlőpult használ. Használhatja az előfizetéskezelés szkriptelésére, az értesítési előzmények saját rendszereibe húzására vagy az értesítések belső eszközökkel való integrálására. Minden fizetős csomag tartalmazza az API-hozzáférést — csomagonkénti kulcskorlátokért lásd a Tarif kezelése oldalt.

1. lépés — Nyisd meg az API-kulcsok oldalt

Az oldalsávból kattints az API-kulcsok elemre (a Hozzáférési kulcsok alatt).

2. lépés — Hozz létre egy kulcsot

1. Kattints a Kulcs létrehozása gombra.
2. Adj a kulcsnak egy nevet (pl. produkcios-szerver, helyi-dev). A név csak címke — nem befolyásolja az engedélyeket.
3. Kattints a Létrehozás gombra.

A kulcs teljes értéke egyszer jelenik meg — azonnal másold át a titokkezelődbe. A WallaWhats csak egy hasht plus egy rövid előtagot (bws_xxxxxxxx…) tárol, így később nem helyreállítható.

Bánj a kulcsokkal mint jelszavakkal

Aki rendelkezik a kulccsal, az tud cselekedni a fiókodon. Tárold a kulcsokat titokkezelőben, soha ne commitold gitbe, és időnként rotáld őket.

3. lépés — Használd a kulcsot

Küldd a kulcsot az x-api-key fejlécben minden kérésnél:

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

Az elérhető végpontok, kéréstörzsek és válaszformák az API hivatkozás oldalon vannak dokumentálva.

4. lépés — Rotálás vagy visszavonás

• Rotálás — hozz létre egy új kulcsot, telepítsd, majd töröld a régit. Tervezés szerint nincs „rotálás" gomb; létrehozás-aztán-törlés atomivá teszi az átállást.
• Visszavonás — kattints a kulcs sora melletti Törlés gombra. A kulcs azonnal működésképtelenné válik. Bármely folyamatban lévő, azt használó kérés 401 Unauthorized választ ad.

Csomagkorlátok

Csomag	API-kulcsok
Free	1
Pro	1
Pro+	2
Business	5
Enterprise	20

Ha eléred a korlátot, a Kulcs létrehozása letiltásra kerül — először törölj egy régi kulcsot, vagy frissíts csomagot.

Következő

A kérés/válasz sémákért és a teljes végpontlistáért lásd az API hivatkozást →.