Skip to main content
API-innstillinger er der du oppretter API-tokens. Et API-token lar dine egne systemer, eller en utvikler som jobber for deg, snakke direkte med Zippendo: opprette sendinger, lese ordrer, eller koble til et lager- eller administrasjonssystem.

​
Hvor du finner det

Åpne organisasjonsmenyen nederst i sidefeltet, klikk på Administrer, og deretter på fanen API-innstillinger. Du ser tokenene dine og en knapp Legg til API-token. Alle planer inkluderer API-tokens: Free opptil 2, Standard 5, Growth 10, Pro og Enterprise ubegrenset.

​
Opprett et API-token

1

Åpne vinduet

Klikk på Legg til API-token (eller Opprett ditt første token hvis listen er tom).
2

Gi tokenet et navn

Skriv inn et Navn på token *, for eksempel «WMS-integrasjon» eller «Administrasjon», slik at du kjenner det igjen senere. Du kan også sette Utløper om (dager) (opptil 365) og, hvis organisasjonen din har merkevarer, Begrens til merkevare.
3

Velg tillatelsene

Kryss av for Tillatelser * tokenet trenger, for eksempel Vis sendinger og Rediger sendinger.
4

Opprett og kopier tokenet

Klikk på Opprett token. Hele tokenet vises én gang, i API-tokenet er opprettet. Klikk på Kopier og lagre det et trygt sted: du kan ikke se det igjen etter at du har lukket vinduet.
Behandle et API-token som et passord. Ikke del det og ikke legg det i kode som andre kan se. Hvis et token kommer på avveie, sletter du det og oppretter et nytt.

​
Bruk av tokenet

Utvikleren din sender tokenet i Authorization-headeren i hver forespørsel: Authorization: Bearer YOUR_TOKEN Adressen du skal kalle og alle forespørsler står i API-referansen. Et token når bare dataene til din egen organisasjon.

​
Begrense et token til en merkevare

Hvis organisasjonen din bruker merkevarer, kan du sette Begrens til merkevare når du oppretter et token. Hver forespørsel som gjøres med det tokenet, kan da bare lese og skrive dataene til den merkevaren. Du kan ikke endre eller fjerne merkevaren senere, så opprett et nytt token hvis du trenger et annet. Et token uten merkevare fungerer for hele organisasjonen. En utvikler kan likevel rette én enkelt forespørsel mot én merkevare med headeren X-Zippendo-Brand, og sette en standard for listeforespørsler med headeren X-Zippendo-Brand-Scope (own, shared eller both). Se Merkevarer og API-referansen.

​
Slette et token

For å stoppe et token fra å virke, for eksempel når en integrasjon er avviklet eller tokenet har vært eksponert, klikker du på Slett på raden i API-innstillinger. Skriv navnet på tokenet med store bokstaver og bekreft. Alle systemer som bruker tokenet, slutter å virke med en gang. Opprett et nytt token hvis de skal fortsette å kjøre. Hvert felt i detalj: Opprett et API-token.