Skip to main content
API-indstillinger er stedet, hvor du opretter API-tokens. Et API-token lader dine egne systemer eller en udvikler, der arbejder for dig, tale direkte med Zippendo: oprette forsendelser, læse ordrer eller forbinde et lager- eller back office-system.

​
Her finder du det

Åbn organisationsmenuen nederst i sidemenuen, klik på Administrer og derefter på fanen API-indstillinger. Du ser dine tokens og en knap Tilføj API-token. Alle planer inkluderer API-tokens: Free op til 2, Standard 5, Growth 10, Pro og Enterprise ubegrænset.

​
Opret et API-token

1

Åbn vinduet

Klik på Tilføj API-token (eller Opret dit første token, hvis listen er tom).
2

Giv tokenet et navn

Skriv et Tokennavn *, f.eks. “WMS-integration” eller “Back office”, så du kan genkende det senere. Du kan også angive Udløber om (dage) (op til 365) og, hvis din organisation har brands, Begræns til brand.
3

Vælg rettighederne

Sæt kryds ved de Rettigheder *, tokenet har brug for, f.eks. Se forsendelser og Rediger forsendelser.
4

Opret og kopier tokenet

Klik på Opret token. Det fulde token vises én gang i API-token oprettet. Klik på Kopier, og gem det et sikkert sted: du kan ikke se det igen, når du har lukket vinduet.
Behandl et API-token som en adgangskode. Del det ikke, og læg det ikke i kode, andre kan se. Hvis et token kommer ud, så slet det, og opret et nyt.

​
Sådan bruges tokenet

Din udvikler sender tokenet i headeren Authorization i hver anmodning: Authorization: Bearer YOUR_TOKEN Adressen, der skal kaldes, og alle anmodninger finder du i API-referencen. Et token kan kun nå din egen organisations data.

​
Begræns et token til et brand

Hvis din organisation bruger brands, kan du vælge Begræns til brand, når du opretter et token. Alle anmodninger med det token kan så kun læse og skrive det brands data. Du kan ikke ændre eller fjerne brandet senere, så opret et nyt token, hvis du har brug for et andet. Et token uden brand virker for hele organisationen. En udvikler kan stadig rette en enkelt anmodning mod ét brand med headeren X-Zippendo-Brand og angive en standard for listeanmodninger med headeren X-Zippendo-Brand-Scope (own, shared eller both). Se Brands og API-referencen.

​
Slet et token

For at få et token til at holde op med at virke, f.eks. når en integration er udfaset, eller tokenet er blevet afsløret, skal du klikke på Slet i dets række under API-indstillinger. Skriv tokenets navn med store bogstaver, og bekræft. Alle systemer, der bruger tokenet, holder op med at virke med det samme. Opret et nyt token, hvis de skal fortsætte med at køre. Hvert felt i detaljer: Opret et API-token.