Luo API-token

API-token antaa omille järjestelmillesi tai puolestasi työskentelevälle kehittäjälle mahdollisuuden yhdistää Zippendoon: luoda lähetyksiä, lukea tilauksia, rekisteröidä webhookeja ja tehdä kaiken muun, mitä API-viitteessä on. Luot tokenit kohdassa API-asetukset. Zippendo näyttää koko tokenin vain kerran, heti luomisen jälkeen. Asetusten esittely: Asetukset, tiimi ja brändit. Ensimmäinen pyyntö: REST API -pikaopas. Toimitushinnat kassalla: Hae toimitushinta.

Jokainen paketti sisältää API-tokeneita: Free enintään 2, Standard 5, Growth 10, Pro ja Enterprise rajattomasti. Kun raja täyttyy, tokenin luominen epäonnistuu viestillä Olet saavuttanut pakettisi rajan. Vaihda pakettia tai poista jotain, mitä et enää käytä. Poista token, jota et enää käytä, tai vaihda pakettia.

Mistä se löytyy

Avaa sivupalkin alareunan organisaatiovalikko, napsauta Hallitse ja sitten API-asetukset-välilehteä. Painike tokenin luomiseen on Lisää API-token oikeassa yläkulmassa.

API-tokenien luettelo

Sarake	Mitä se näyttää
Nimi	Antamasi Tokenin nimi.
Token	Tokenin ensimmäiset merkit ja perässä `...`. Koko tokenia ei koskaan näytetä tässä.
Oikeudet	Enintään kolme oikeutta, kuten Lähetysten katselu, loput on tiivistetty. Ei oikeuksia, jos mitään ei valittu.
Viimeksi käytetty	Milloin tokenia käytettiin viimeksi, tai Ei koskaan.
Luoja	Tiimin jäsen, joka loi sen.
Vanhenee	Vanhenemispäivä tai Ei koskaan. Menneisyydessä oleva päivämäärä näkyy punaisella.
Luotu	Milloin se luotiin.

Ainoa asia, jonka voit tehdä luettelon tokenille, on Poista se. Tokenia ei voi muokata tai nimetä uudelleen. Kun tokeneita ei vielä ole, luettelossa lukee Ei API-tokeneita ja näkyvillä on Luo ensimmäinen token -painike.

Luo token

Avaa ikkuna

Napsauta Lisää API-token tai Luo ensimmäinen token, kun luettelo on tyhjä. Luo API-token -ikkuna avautuu.

Nimeä token

Täytä Tokenin nimi *, esimerkiksi “Warehouse WMS”. Voit halutessasi asettaa Voimassa (päivää) ja Rajaa brändiin.

Valitse oikeudet

Merkitse, mitä token saa tehdä, tai napsauta Valitse kaikki.

Luo se

Napsauta Luo token. Näet viestin API-token luotu, ja API-token luotu -ikkuna avautuu koko tokenin kanssa.

Luo API-token -ikkuna, jossa Tokenin nimi, Voimassa (päivää) ja oikeuksien valintaruudut — Luo API-token: nimi, valinnainen vanheneminen ja sitten oikeudet

Kenttä	Pakollinen	Mitä kirjoittaa
Tokenin nimi *	Kyllä	Nimi, joka kertoo, missä tokenia käytetään, kuten “Production API” tai “Webhook Service”. Enintään 100 merkkiä.
Rajaa brändiin	Ei	Näkyy vain, jos organisaatiollasi on brändejä. Valitse brändi, jolloin Tätä tokenia käyttävät sovellukset ja järjestelmät näkevät ja voivat muuttaa vain tämän brändin tietoja. Oletus on Ei brändiä (koko organisaatio). Tätä ei voi muuttaa myöhemmin.
Voimassa (päivää)	Ei	Luku väliltä 1-365. Token lakkaa toimimasta, kun näin monta päivää on kulunut. Jätä tyhjäksi, jos haluat tokenin, joka ei vanhene.
Oikeudet *	Kyllä, vähintään yksi	Mitä token saa lukea ja muuttaa. Katso alla oleva luettelo.

Luo token pysyy harmaana, kunnes tokenilla on nimi ja vähintään yksi oikeus.

Oikeudet

Jokaisella alueella on Luku-oikeus (Tietojen katselu ja lukeminen) ja Kirjoitus-oikeus (Luonti, muokkaus ja poisto). Kirjoitus-oikeus sisältää Luku-oikeuden samalle alueelle.

Oikeus	Kattaa
Lähetysten katselu / Lähetysten muokkaus	Lähetykset
Toimitussääntöjen katselu / Toimitussääntöjen muokkaus	Toimitussäännöt ja toimitushinnat
Kuljetusyhtiöiden katselu / Kuljetusyhtiöiden muokkaus	Yhdistetyt kuljetusyhtiöt
Osoitteiden katselu / Osoitteiden muokkaus	Lähettäjän osoitteet
Organisaation katselu / Organisaation muokkaus	Organisaatiosi tiedot
Tiimin jäsenten katselu / Tiimin jäsenten muokkaus	Tiimin jäsenet
API-tokenien katselu / API-tokenien muokkaus	Muut API-tokenit
Kaikkien tietojen katselu / Kaikkien tietojen muokkaus	Kaikki yllä oleva paitsi API-tokenit sekä tilaukset, myyntikanavat, tulostimet, webhookit, automaatiot, integraatiot ja roolit

Tilauksilla, myyntikanavilla, tulostimilla, webhookeilla, automaatioilla ja integraatioilla ei ole omaa oikeutta: tokenilla, joka tarvitsee niitä, on oltava Kaikkien tietojen katselu tai Kaikkien tietojen muokkaus. Kumpikaan niistä ei sisällä API-tokeneita, joten merkitse myös API-tokenien muokkaus, jos tokenin on luotava tai poistettava muita tokeneita. Samoja oikeuksia käytetään mukautetuissa rooleissa.

Kopioi token (kerran)

API-token luotu näyttää koko tokenin, joka alkaa zipp_. Ikkuna varoittaa: Muista kopioida tämä token. Et näe sitä enää, kun suljet tämän ikkunan.

API-token luotu -ikkuna, jossa token, Kopioi-painike ja Tärkeää-varoitus — API-token luotu: kopioi token ennen kuin suljet ikkunan

Napsauta Kopioi. Näet viestin Token kopioitu leikepöydälle. Jos näet viestin Tokenin kopioiminen epäonnistui, valitse token ja kopioi se käsin. Sulje sitten ikkuna. Jos menetät tokenin, poista se ja luo uusi.

Kohtele tokenia kuin salasanaa. Älä laita sitä koodiin, jonka muut näkevät, tai verkkosivulle. Jos se vuotaa, poista se (katso alla “Poista token”) ja luo uusi. Epäonnistuvat pyynnöt: API-tokenin todennusvirheet.

Käytä tokenia

Kehittäjäsi lähettää tokenin jokaisen pyynnön mukana:

curl https://api.zippendo.com/orgs/{orgId}/shipments \
  -H "Authorization: Bearer zipp_YOUR_TOKEN" \
  -H "Content-Type: application/json"

{orgId} on organisaatiosi ID, ei sovelluksen osoiterivillä näkyvä nimi. Kehittäjä voi luetella sen API-viitteen Orgs-pyynnöillä, API-viitteessä, jossa jokainen pyyntö ja vastaus on kuvattu. Valmiit asiakasohjelmistot: SDK:t. Rajat: Käyttörajat. Token ilman brändiä voi kohdistaa yksittäisen pyynnön yhteen brändiin X-Zippendo-Brand-otsakkeella. Token, joka luotiin kohdalla Rajaa brändiin, pysyy aina brändinsä sisällä. Katso Brändit.

Poista token

Napsauta Poista tokenin rivillä. Poista API-token pyytää kirjoittamaan tokenin nimen isoilla kirjaimilla, esimerkiksi WAREHOUSE WMS, ja napsauttamaan sitten Poista. Näet viestin API-token poistettu. Mikään tokenia käyttävä järjestelmä ei enää pysty yhdistämään. Poistoa ei voi perua, eikä tokenia voi sen sijaan keskeyttää.

Poista API-token -ikkuna, jossa kenttä nimen kirjoittamista varten vahvistukseksi — Poista API-token: vahvista kirjoittamalla nimi isoilla kirjaimilla

Liittyvää

Webhookit: Zippendo kertoo järjestelmällesi, kun jotain tapahtuu, sen sijaan että järjestelmäsi kysyisi.
Yhdistä Slack, Klaviyo ja muut sovellukset: valmiit yhteydet, jotka eivät tarvitse API-tokenia.
Mukautetun kanavan API: lähetä tilaukset omasta kaupastasi tai järjestelmästäsi Zippendoon.
Hae toimitushinta: toimitushinnat kassalla.
MCP-todennus: yhdistä tekoälyagentti ilman tokenin liittämistä.

Yleiskatsaus

Lähetykset

Tilaukset ja kanavat

Kuljetusyhtiöt

Yhdistä kuljetusyhtiö

Yhdistä integraatio

Tulostus

Automaatio

Tili

Haku ja hallintapaneeli

API ja tapahtumat

Mistä se löytyy

API-tokenien luettelo

Luo token

Oikeudet

Kopioi token (kerran)

Käytä tokenia

Poista token

Liittyvää

​Mistä se löytyy

​API-tokenien luettelo

​Luo token

​Oikeudet

​Kopioi token (kerran)

​Käytä tokenia

​Poista token

​Liittyvää

Mistä se löytyy

API-tokenien luettelo

Luo token

Oikeudet

Kopioi token (kerran)

Käytä tokenia

Poista token

Liittyvää