Skip to main content
Med en API-token kan ditt eget system eller en utvecklares skript arbeta med Zippendo. Du skapar tokens under Inställningar → API-inställningar (öppna organisationsmenyn och klicka på Hantera). Om ett anrop avvisas visar svaret varför.

Det här ser du

  • 401 Unauthorized med Invalid or expired token eller Authentication required.
  • 403 Forbidden med Missing required scope eller Du har inte åtkomst till den här organisationen.
  • 429 Too Many Requests med API rate limit of … requests per minute reached.
  • Anropet fungerar i Zippendo-appen men misslyckas från ditt skript eller din server.

401: token godtas inte

Skicka token så här, med ordet Bearer och ett mellanslag före den:
Kontrollera att:
  1. Token börjar med zipp_ och har kopierats i sin helhet, utan mellanslag eller radbrytningar i slutet.
  2. Token fortfarande finns under API-inställningar. Om du raderar en token slutar den fungera direkt.
  3. Token inte har gått ut. Kolumnen Går ut visar datumet. En token som skapades utan Går ut om (dagar) går aldrig ut.
Zippendo visar en token bara en gång, i API-token har skapats. Om du inte har den kvar skapar du en ny token med Lägg till API-token och raderar den gamla. Se Skapa en API-token.

403: token får inte göra detta

429: för många anrop

Varje plan tillåter ett visst antal API-anrop per minut: När du överskrider gränsen är svaret API rate limit of … requests per minute reached. Please retry in … s. Headern Retry-After anger hur många sekunder du ska vänta. Vänta så länge, försök igen och sprid ut dina anrop. Mer information: Anropsgränser.

Du kan inte skapa en till token

Du har nått gränsen i din plan. Uppgradera planen eller ta bort något du inte längre använder. betyder att antalet API-tokens i din plan är slut: 2 på Free, 5 på Standard, 10 på Growth och ingen gräns på Pro och Enterprise. Radera en token som du inte längre använder, eller uppgradera.

Bra vanor

  • Förvara tokens på din server. Lägg aldrig en token på en webbutikssida eller i annan kod som körs i en kunds webbläsare.
  • Ge varje system en egen token, med bara de behörigheter det behöver. Då kan du radera en utan att stoppa de andra.
Se även: Snabbstart för REST API, API-inställningar, API-översikt.