Skip to main content
API-asetukset on paikka, jossa luot API-tokeneita. API-token antaa omien järjestelmiesi tai sinulle työskentelevän kehittäjän keskustella suoraan Zippendo-palvelun kanssa: luoda lähetyksiä, lukea tilauksia tai yhdistää varasto- tai taustajärjestelmä.

Mistä sen löytää

Avaa organisaatiovalikko sivupalkin alareunasta, napsauta Hallitse ja sitten API-asetukset-välilehteä. Näet tokenisi ja Lisää API-token -painikkeen. Jokainen paketti sisältää API-tokenit: Free enintään 2, Standard 5, Growth 10, Pro ja Enterprise rajattomasti.

Luo API-token

1

Avaa ikkuna

Napsauta Lisää API-token (tai Luo ensimmäinen token, jos luettelo on tyhjä).
2

Nimeä token

Kirjoita Tokenin nimi *, esimerkiksi “WMS-integraatio” tai “Taustajärjestelmä”, jotta tunnistat sen myöhemmin. Voit myös asettaa Voimassa (päivää) (enintään 365) ja, jos organisaatiossasi on brändejä, Rajaa brändiin.
3

Valitse oikeudet

Valitse tokenin tarvitsemat Oikeudet *, esimerkiksi Lähetysten katselu ja Lähetysten muokkaus.
4

Luo ja kopioi token

Napsauta Luo token. Koko token näytetään kerran kohdassa API-token luotu. Napsauta Kopioi ja tallenna se turvalliseen paikkaan: et näe sitä enää, kun suljet ikkunan.
Käsittele API-tokenia kuin salasanaa. Älä jaa sitä äläkä laita sitä koodiin, jonka muut näkevät. Jos token vuotaa, poista se ja luo uusi.

Tokenin käyttö

Kehittäjäsi lähettää tokenin jokaisen pyynnön Authorization-otsakkeessa: Authorization: Bearer YOUR_TOKEN Kutsuttava osoite ja kaikki pyynnöt ovat sivulla API reference. Token yltää vain oman organisaatiosi tietoihin.

Tokenin rajaaminen brändiin

Jos organisaatiosi käyttää brändejä, voit asettaa Rajaa brändiin tokenia luodessasi. Jokainen tällä tokenilla tehty pyyntö voi silloin lukea ja kirjoittaa vain kyseisen brändin tietoja. Et voi muuttaa tai poistaa brändiä myöhemmin, joten luo uusi token, jos tarvitset toisen. Token ilman brändiä toimii koko organisaatiolle. Kehittäjä voi silti kohdistaa yksittäisen pyynnön yhteen brändiin X-Zippendo-Brand-otsakkeella ja asettaa luettelopyyntöjen oletuksen X-Zippendo-Brand-Scope-otsakkeella (own, shared tai both). Katso Brändit ja API reference.

Tokenin poistaminen

Jos haluat estää tokenia toimimasta, esimerkiksi kun integraatio poistetaan käytöstä tai token paljastui, napsauta Poista sen rivillä kohdassa API-asetukset. Kirjoita tokenin nimi isoilla kirjaimilla ja vahvista. Jokainen järjestelmä, joka käyttää tokenia, lakkaa toimimasta heti. Luo uusi token, jos sen pitää jatkaa toimintaa. Jokainen kenttä tarkemmin: Luo API-token.