Skip to main content
Et API-token lar ditt eget system eller en utviklers skript jobbe med Zippendo. Du oppretter tokens under Innstillinger → API-innstillinger (åpne organisasjonsmenyen og klikk på Administrer). Hvis et kall avvises, sier svaret hvorfor.

​
Dette ser du

  • 401 Unauthorized med Invalid or expired token eller Authentication required.
  • 403 Forbidden med Missing required scope eller Du har ikke tilgang til denne organisasjonen.
  • 429 Too Many Requests med API rate limit of … requests per minute reached.
  • Kallet fungerer i Zippendo-appen, men mislykkes fra skriptet eller serveren din.

​
401: tokenet godtas ikke

Send tokenet slik, med ordet Bearer og ett mellomrom foran:
Sjekk at:
  1. Tokenet begynner med zipp_ og ble kopiert i sin helhet, uten mellomrom eller linjeskift på slutten.
  2. Tokenet fortsatt finnes under API-innstillinger. Når du sletter et token, stopper det med en gang.
  3. Tokenet ikke har utløpt. Kolonnen Utløper viser datoen. Et token som er opprettet uten Utløper om (dager), utløper aldri.
Zippendo viser et token bare én gang, i API-tokenet er opprettet. Hvis du ikke lenger har det, oppretter du et nytt token med Legg til API-token og sletter det gamle. Se Opprett et API-token.

​
403: tokenet har ikke lov til dette

​
429: for mange kall

Hver plan tillater et visst antall API-kall per minutt: Når du går over, er svaret API rate limit of … requests per minute reached. Please retry in … s. Headeren Retry-After sier hvor mange sekunder du må vente. Vent så lenge, prøv igjen, og spre kallene dine utover. Mer: Hastighetsbegrensning.

​
Du kan ikke opprette et nytt token

Du har nådd grensen i planen din. Oppgrader planen eller fjern noe du ikke bruker lenger. betyr at antallet API-tokens i planen din er brukt opp: 2 på Free, 5 på Standard, 10 på Growth, og ingen grense på Pro og Enterprise. Slett et token du ikke bruker lenger, eller oppgrader.

​
Gode vaner

  • Hold tokens på serveren din. Legg aldri et token på en nettbutikkside eller i annen kode som kjører i kundens nettleser.
  • Gi hvert system sitt eget token, med bare de tillatelsene det trenger. Da kan du slette ett uten å stoppe de andre.
Relatert: Hurtigstart for REST API, API-innstillinger, API-oversikt.