Skip to content

API juurdepääs

WallaWhats avalikustab samad operatsioonid, mida armatuurlaud kasutab, JSON HTTP API kaudu. Kasutage seda tellimuste haldamise skriptimiseks, märguannete ajaloo tõmbamiseks oma süsteemidesse või märguannete integreerimiseks sisemiste tööriistadega. Iga tasuline tase sisaldab API juurdepääsu — vt Halda plaani plaani-põhiste võtmepiirangute kohta.

1. samm — Avage API võtmed

Külgribalt klõpsake API võtmed (jaotises Juurdepääsuvõtmed).

API võtmete leht ühe vaikevõtmega

2. samm — Looge võti

  1. Klõpsake Loo võti.
  2. Andke võtmele nimi (nt production-server, local-dev). Nimi on lihtsalt silt — see ei mõjuta õigusi.
  3. Klõpsake Loo.

Võtme täisväärtus näidatakse üks kord — kopeerige see kohe oma saladuste haldurisse. WallaWhats salvestab ainult hashi pluss lühikese eesliidet (bws_xxxxxxxx…), seega ei saa seda hiljem taastada.

Käsitlege võtmeid nagu paroole

Kõik võtme omanikud saavad teie kontol tegutseda. Hoidke võtmeid saladuste halduris, ärge kunagi commitige neid gitti ja roteerige perioodiliselt.

3. samm — Kasutage võtit

Saatke võti igas päringus x-api-key päises:

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

Saadaval olevad lõpp-punktid, päringute kehad ja vastuste vormid on dokumenteeritud API viites.

4. samm — Rotatsioon või tühistamine

  • Rotatsioon — looge uus võti, juurutage see, seejärel kustutage vana. Kavandi järgi ei ole "rotatsiooni" nuppu; loo-siis-kustuta muudab ülemineku atomaarseks.
  • Tühistage — klõpsake võtme rea kõrval Kustuta. Võti lõpetab töö kohe. Kõik selle kasutusel olevad pooleliolevad päringud tagastavad 401 Unauthorized.

Plaanipiirangud

PlaanAPI võtmed
Free1
Pro1
Pro+2
Business5
Enterprise20

Kui jõuate piirini, on Loo võti keelatud — kustutage esmalt vana võti või uuendage plaani.

Mis järgmiseks

Päringu/vastuse skeemide ja täieliku lõpp-punktide loendi jaoks vaadake API viidet →.

WallaWhats Documentation