API-pääsy

WallaWhats paljastaa samat toiminnot kuin koontinäyttö käyttää JSON HTTP API:n kautta. Käytä sitä tilausten hallinnan skriptaamiseen, ilmoitushistorian noutamiseen omiin järjestelmiisi tai ilmoitusten integroimiseen sisäisiin työkaluihin. Jokainen maksullinen taso sisältää API-pääsyn — katso Hallinnoi tilausta kunkin tilauksen avainrajoituksia varten.

Vaihe 1 — Avaa API-avaimet

Sivupalkista napsauta API-avaimet (kohdan Pääsyavaimet alla).

Vaihe 2 — Luo avain

1. Napsauta Luo avain.
2. Anna avaimelle nimi (esim. tuotantopalvelin, paikallinen-dev). Nimi on vain etiketti — se ei vaikuta oikeuksiin.
3. Napsauta Luo.

Avaimen koko arvo näytetään kerran — kopioi se välittömästi salaisuuksien hallintaohjelmaasi. WallaWhats tallentaa vain hashin ja lyhyen etuliitteen (bws_xxxxxxxx…), joten sitä ei voida palauttaa myöhemmin.

Käsittele avaimia kuin salasanoja

Jokainen, jolla on avain, voi toimia tililläsi. Tallenna avaimet salaisuuksien hallintaohjelmaan, älä koskaan committaa niitä gitiin, ja kierrätä säännöllisesti.

Vaihe 3 — Käytä avainta

Lähetä avain x-api-key-otsakkeessa jokaisessa pyynnössä:

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

Käytettävissä olevat päätepisteet, pyyntörungot ja vastausmuodot on dokumentoitu API-viitteessä.

Vaihe 4 — Kierrätys tai peruuttaminen

• Kierrätys — luo tuore avain, ota se käyttöön, poista sitten vanha. Suunnittelusta johtuen ei ole "kierrätys"-painiketta; luo-sitten-poista tekee siirtymästä atomisen.
• Peruuttaa — napsauta Poista avaimen rivin vieressä. Avain lakkaa toimimasta välittömästi. Mikä tahansa sitä käyttävä käynnissä oleva pyyntö palauttaa 401 Unauthorized.

Tilauksen rajat

Tilaus	API-avaimet
Free	1
Pro	1
Pro+	2
Business	5
Enterprise	20

Jos saavutat rajan, Luo avain on poissa käytöstä — poista ensin vanha avain tai päivitä tilauksesi.

Mitä seuraavaksi

Pyyntö-/vastauskaavakkeita ja täydellistä päätepisteluetteloa varten katso API-viite →.