Fejl ved godkendelse med API-token

Et API-token lader dit eget system eller en udviklers script arbejde med Zippendo. Du opretter tokens under Indstillinger → API-indstillinger (åbn organisationsmenuen og klik på Administrer). Hvis et kald afvises, fortæller svaret hvorfor.

Det ser du

401 Unauthorized med Invalid or expired token eller Authentication required.
403 Forbidden med Missing required scope eller Du har ikke adgang til denne organisation.
429 Too Many Requests med API rate limit of … requests per minute reached.
Kaldet virker i Zippendo-appen, men mislykkes fra dit script eller din server.

401: tokenet accepteres ikke

Besked	Sandsynlig årsag	Det skal du gøre
`Authentication required`	Der blev ikke sendt noget token	Send tokenet i headeren `Authorization`, som vist nedenfor
`Invalid or expired token`	Tokenet er skrevet forkert, afskåret, slettet eller udløbet	Tjek tokenet som beskrevet nedenfor. Er du i tvivl, så opret et nyt
`Invalid token type`	Noget andet end et API-token blev sendt, for eksempel en værdi kopieret fra browseren	Brug det token, der blev vist, da du klikkede på Opret token

Send tokenet sådan, med ordet Bearer og ét mellemrum foran:

Authorization: Bearer zipp_YOUR_TOKEN

Tjek, at:

Tokenet starter med zipp_ og er kopieret helt, uden mellemrum eller linjeskift til sidst.
Tokenet stadig findes under API-indstillinger. Når du sletter et token, stopper det med det samme.
Tokenet ikke er udløbet. Kolonnen Udløber viser datoen. Et token, der er oprettet uden Udløber om (dage), udløber aldrig.

Zippendo viser et token kun én gang, i API-token oprettet. Hvis du ikke længere har det, så opret et nyt token med Tilføj API-token og slet det gamle. Se Opret et API-token.

403: tokenet har ikke lov til at gøre det

Besked	Sandsynlig årsag	Det skal du gøre
`Missing required scope`, efterfulgt af et rettighedsnavn som `write:shipments`	Tokenet blev oprettet uden den rettighed	Opret et nyt token og sæt kryds ved rettigheden under Rettigheder . Kolonnen Rettigheder* viser, hvad hvert token kan
Du har ikke adgang til denne organisation.	Organisationen i kaldets adresse er ikke den, tokenet hører til	Brug den organisation, tokenet blev oprettet i, eller opret et token i den anden organisation
Denne funktion er ikke med i dit nuværende abonnement. Opgrader for at bruge den.	Den funktion, du kaldte, er ikke en del af din plan	Se Fakturering og forbrug

429: for mange kald

Hver plan tillader et antal API-kald pr. minut:

Plan	Kald pr. minut
Free	10
Standard	60
Growth	200
Pro	1.000
Enterprise	100.000

Når du overskrider det, er svaret API rate limit of … requests per minute reached. Please retry in … s. Headeren Retry-After angiver, hvor mange sekunder du skal vente. Vent så længe, prøv igen, og spred dine kald ud. Mere: Rate limits.

Du kan ikke oprette flere tokens

Du har nået grænsen for dit abonnement. Opgrader dit abonnement, eller fjern noget, du ikke længere bruger. betyder, at din plans antal API-tokens er brugt: 2 på Free, 5 på Standard, 10 på Growth og ingen grænse på Pro og Enterprise. Slet et token, du ikke længere bruger, eller opgrader.

Gode vaner

Hold tokens på din server. Sæt aldrig et token på en webshopside eller i anden kode, der kører i en kundes browser.
Giv hvert system sit eget token med kun de rettigheder, det har brug for. Så kan du slette ét uden at stoppe de andre.

Relateret: Hurtigstart til REST API, API-indstillinger, API-overblik.

Start her

Integrationer og API

Automatisering og afhentninger

Fejl ved godkendelse med API-token

Det ser du

401: tokenet accepteres ikke

403: tokenet har ikke lov til at gøre det

429: for mange kald

Du kan ikke oprette flere tokens

Gode vaner

​Det ser du

​401: tokenet accepteres ikke

​403: tokenet har ikke lov til at gøre det

​429: for mange kald

​Du kan ikke oprette flere tokens

​Gode vaner

Det ser du

401: tokenet accepteres ikke

403: tokenet har ikke lov til at gøre det

429: for mange kald

Du kan ikke oprette flere tokens

Gode vaner