Skip to main content
API-token antaa omalle järjestelmällesi tai kehittäjän skriptille mahdollisuuden toimia Zippendon kanssa. Luot tokenit kohdassa Asetukset → API-asetukset (avaa organisaatiovalikko ja napsauta Hallitse). Jos kutsu hylätään, vastaus kertoo syyn.

​
Mitä näet

  • 401 Unauthorized ja Invalid or expired token tai Authentication required.
  • 403 Forbidden ja Missing required scope tai Sinulla ei ole pääsyä tähän organisaatioon.
  • 429 Too Many Requests ja API rate limit of … requests per minute reached.
  • Kutsu toimii Zippendo-sovelluksessa mutta epäonnistuu skriptistäsi tai palvelimeltasi.

​
401: tokenia ei hyväksytä

Lähetä token näin, sanalla Bearer ja yhdellä välilyönnillä sen edessä:
Tarkista, että:
  1. Token alkaa zipp_ ja se kopioitiin kokonaan, ilman välilyöntejä tai rivinvaihtoja lopussa.
  2. Token on edelleen olemassa kohdassa API-asetukset. Tokenin poistaminen pysäyttää sen heti.
  3. Token ei ole vanhentunut. Vanhenee-sarake näyttää päivämäärän. Token, joka luotiin ilman kohtaa Voimassa (päivää), ei vanhene koskaan.
Zippendo näyttää tokenin vain kerran, kohdassa API-token luotu. Jos sinulla ei enää ole sitä, luo uusi token kohdalla Lisää API-token ja poista vanha. Katso Luo API-token.

​
403: tokenilla ei ole lupaa tähän

​
429: liikaa kutsuja

Jokainen paketti sallii tietyn määrän API-kutsuja minuutissa: Kun ylität rajan, vastaus on API rate limit of … requests per minute reached. Please retry in … s. Retry-After-otsake kertoo, kuinka monta sekuntia odottaa. Odota se aika, yritä sitten uudelleen ja hajauta kutsusi. Lisää: Käyttörajat.

​
Et voi luoda toista tokenia

Olet saavuttanut pakettisi rajan. Vaihda pakettia tai poista jotain, mitä et enää käytä. tarkoittaa, että pakettisi API-tokenien määrä on käytetty: 2 Free-paketissa, 5 Standard-paketissa, 10 Growth-paketissa ja ei rajaa Pro- ja Enterprise-paketeissa. Poista token, jota et enää käytä, tai vaihda pakettia.

​
Hyvät tavat

  • Pidä tokenit palvelimellasi. Älä koskaan laita tokenia verkkokaupan sivulle tai muuhun koodiin, joka ajetaan asiakkaan selaimessa.
  • Anna jokaiselle järjestelmälle oma token, jolla on vain tarvittavat oikeudet. Silloin voit poistaa yhden pysäyttämättä muita.
Liittyvää: REST API -pikaopas, API-asetukset, API:n yleiskatsaus.