Skip to main content
API-inställningar är platsen där du skapar API-tokens. En API-token låter dina egna system, eller en utvecklare som arbetar åt dig, kommunicera direkt med Zippendo: skapa försändelser, läsa ordrar eller ansluta ett lagersystem eller ett administrativt system.

Var du hittar den

Öppna organisationsmenyn längst ned i sidofältet, klicka på Hantera och sedan på fliken API-inställningar. Du ser dina tokens och en knapp Lägg till API-token. Alla planer inkluderar API-tokens: Free upp till 2, Standard 5, Growth 10, Pro och Enterprise obegränsat.

Skapa en API-token

1

Öppna fönstret

Klicka på Lägg till API-token (eller Skapa din första token om listan är tom).
2

Ge token ett namn

Ange ett Namn på token *, till exempel ”WMS-integration” eller ”Back office”, så att du känner igen den senare. Du kan också ange Går ut om (dagar) (upp till 365) och, om din organisation har varumärken, Begränsa till varumärke.
3

Välj behörigheterna

Markera de Behörigheter * som token behöver, till exempel Visa försändelser och Redigera försändelser.
4

Skapa och kopiera token

Klicka på Skapa token. Hela token visas en gång, i API-token har skapats. Klicka på Kopiera och spara den på ett säkert ställe: du kan inte se den igen när du har stängt fönstret.
Behandla en API-token som ett lösenord. Dela den inte och lägg den inte i kod som andra kan se. Om en token kommer ut raderar du den och skapar en ny.

Använda token

Din utvecklare skickar token i headern Authorization i varje förfrågan: Authorization: Bearer YOUR_TOKEN Adressen att anropa och alla förfrågningar finns i API-referensen. En token når bara data i din egen organisation.

Begränsa en token till ett varumärke

Om din organisation använder varumärken kan du ange Begränsa till varumärke när du skapar en token. Varje förfrågan som görs med den token kan då bara läsa och skriva det varumärkets data. Du kan inte ändra eller ta bort varumärket senare, så skapa en ny token om du behöver en annan. En token utan varumärke fungerar för hela organisationen. En utvecklare kan ändå rikta en enskild förfrågan mot ett varumärke med headern X-Zippendo-Brand, och ange ett standardvärde för listförfrågningar med headern X-Zippendo-Brand-Scope (own, shared eller both). Se Varumärken och API-referensen.

Radera en token

Om du vill att en token ska sluta fungera, till exempel när en integration tas ur bruk eller token har exponerats, klickar du på Radera på dess rad i API-inställningar. Skriv tokenens namn med versaler och bekräfta. Alla system som använder token slutar fungera direkt; skapa en ny token om de ska fortsätta köras. Varje fält i detalj: Skapa en API-token.