Opprett et API-token

Et API-token lar dine egne systemer, eller en utvikler som jobber for deg, koble til Zippendo: opprette sendinger, lese ordrer, registrere webhooks og alt annet i API-referansen. Du oppretter tokens under API-innstillinger. Zippendo viser hele tokenet bare én gang, rett etter at du har opprettet det. Gjennomgang av innstillingene: Innstillinger, team og merkevarer. Første forespørsel: Hurtigstart for REST API. Fraktpriser i kassen: Hent et frakttilbud.

Alle planer inkluderer API-tokens: Free opptil 2, Standard 5, Growth 10, Pro og Enterprise ubegrenset. Når du har nådd grensen, mislykkes opprettelsen av et token med Du har nådd grensen i planen din. Oppgrader planen eller fjern noe du ikke bruker lenger. Slett et token du ikke bruker lenger, eller oppgrader.

Hvor du finner det

Åpne organisasjonsmenyen nederst i sidemenyen, klikk på Administrer og deretter fanen API-innstillinger. Knappen for å opprette et token er Legg til API-token øverst til høyre.

Listen over API-tokens

Kolonne	Hva den viser
Navn	Navn på token du skrev inn.
Token	De første tegnene i tokenet etterfulgt av `...`. Hele tokenet vises aldri her.
Tillatelser	Opptil tre tillatelser, for eksempel Vis sendinger. Resten er skjult. Ingen tillatelser hvis ingen ble valgt.
Sist brukt	Når tokenet sist ble brukt, eller Aldri.
Opprettet av	Teammedlemmet som opprettet det.
Utløper	Utløpsdatoen, eller Aldri. En dato i fortiden vises i rødt.
Opprettet	Når det ble opprettet.

Det eneste du kan gjøre med et token i listen, er å Slett det. Du kan ikke redigere eller gi nytt navn til et token. Når det ikke finnes noen tokens ennå, viser listen Ingen API-tokens og en knapp Opprett ditt første token.

Opprett et token

Åpne vinduet

Klikk på Legg til API-token, eller på Opprett ditt første token når listen er tom. Vinduet Opprett API-token åpnes.

Gi tokenet et navn

Fyll ut Navn på token *, for eksempel «Warehouse WMS». Du kan også sette Utløper om (dager) og Begrens til merkevare.

Velg tillatelsene

Kryss av for det tokenet skal få lov til, eller klikk på Velg alle.

Opprett det

Klikk på Opprett token. Du ser API-tokenet er opprettet, og et vindu med samme tittel åpnes med hele tokenet.

Vinduet Opprett API-token med Navn på token, Utløper om (dager) og avkrysningsbokser for tillatelser — Opprett API-token: navn, valgfri utløpsdato og deretter tillatelsene

Felt	Påkrevd	Hva du skriver inn
Navn på token *	Ja	Et navn som forteller deg hvor tokenet brukes, for eksempel «Produksjons-API» eller «Webhook-tjeneste». Opptil 100 tegn.
Begrens til merkevare	Nei	Vises bare hvis organisasjonen din har merkevarer. Velg en merkevare, så kan Apper og systemer som bruker dette tokenet, bare se og endre data for denne merkevaren. Standard er Ingen merkevare (hele organisasjonen). Du kan ikke endre dette senere.
Utløper om (dager)	Nei	Et tall fra 1 til 365. Tokenet slutter å fungere etter så mange dager. La feltet stå tomt for et token som aldri utløper.
Tillatelser *	Ja, minst én	Hva tokenet kan lese og endre. Se listen nedenfor.

Opprett token forblir grå til tokenet har et navn og minst én tillatelse.

Tillatelser

Hvert område har en leserettighet (Vise og lese informasjon) og en skriverettighet (Opprette, oppdatere og slette). En skriverettighet inkluderer leserettigheten for samme område.

Tillatelse	Dekker
Vis sendinger / Rediger sendinger	Sendinger
Se fraktregler / Rediger fraktregler	Fraktregler og frakttilbud
Se transportører / Rediger transportører	Tilkoblede transportører
Se adresser / Rediger adresser	Avsenderadresser
Se organisasjonen / Rediger organisasjonen	Opplysningene om organisasjonen din
Se teammedlemmer / Rediger teammedlemmer	Teammedlemmer
Se API-tokens / Rediger API-tokens	Andre API-tokens
Se alt / Rediger alt	Alt over unntatt API-tokens, pluss ordrer, ordrekanaler, skrivere, webhooks, automatiseringer, integrasjoner og roller

Ordrer, ordrekanaler, skrivere, webhooks, automatiseringer og integrasjoner har ingen egen tillatelse: et token som trenger dem, må ha Se alt eller Rediger alt. Ingen av disse inkluderer API-tokens, så kryss også av for Rediger API-tokens hvis tokenet skal kunne opprette eller slette andre tokens. De samme tillatelsene brukes for egendefinerte roller.

Kopier tokenet (én gang)

API-tokenet er opprettet viser hele tokenet, som begynner med zipp_. Vinduet advarer: Husk å kopiere dette tokenet. Du får ikke se det igjen etter at du har lukket dette vinduet.

Vinduet API-tokenet er opprettet med tokenet, en Kopier-knapp og en advarsel med tittelen Viktig — API-tokenet er opprettet: kopier tokenet før du lukker vinduet

Klikk på Kopier. Du ser Tokenet er kopiert til utklippstavlen. Hvis du ser Kunne ikke kopiere tokenet, markerer du tokenet og kopierer det for hånd. Lukk deretter vinduet. Hvis du mister tokenet, sletter du det og oppretter et nytt.

Behandle tokenet som et passord. Ikke legg det i kode som andre kan se, eller på en nettside. Hvis det kommer på avveie, sletter du det (se «Slett et token» nedenfor) og oppretter et nytt. Forespørsler som mislykkes: Autentiseringsfeil for API-token.

Bruk tokenet

Utvikleren din sender tokenet med hver forespørsel:

curl https://api.zippendo.com/orgs/{orgId}/shipments \
  -H "Authorization: Bearer zipp_YOUR_TOKEN" \
  -H "Content-Type: application/json"

{orgId} er ID-en til organisasjonen din, ikke navnet i adressefeltet i appen. En utvikler kan hente den med Orgs-forespørslene i API-referansen, der hver forespørsel og hvert svar er beskrevet. Ferdige klienter: SDK-er. Grenser: Hastighetsbegrensning. Et token uten merkevare kan rette en enkelt forespørsel mot én merkevare med headeren X-Zippendo-Brand. Et token som er opprettet med Begrens til merkevare, holder seg alltid innenfor merkevaren sin. Se Merkevarer.

Slett et token

Klikk på Slett på tokenets rad. Slette API-tokenet? ber deg skrive inn navnet på tokenet med store bokstaver, for eksempel WAREHOUSE WMS, og deretter klikke på Slett. Du ser API-tokenet er slettet. Alle systemer som bruker tokenet, kan ikke lenger koble til. Sletting kan ikke angres, og det finnes ingen måte å sette et token på pause i stedet.

Vinduet Slette API-tokenet? med et felt for å skrive inn navnet som bekreftelse — Slette API-tokenet?: skriv inn navnet med store bokstaver for å bekrefte

Relatert

Webhooks: Zippendo gir systemet ditt beskjed når noe skjer, i stedet for at systemet ditt spør.
Koble til Slack, Klaviyo og andre apper: ferdige tilkoblinger som ikke trenger noe API-token.
API for egendefinert kanal: send ordrer fra din egen butikk eller ditt eget system inn i Zippendo.
Hent et frakttilbud: fraktpriser i kassen.
MCP-autentisering: koble til en AI-agent uten å lime inn et token.

Oversikt

Sendinger

Ordrer og kanaler

Transportører

Koble til en transportør

Koble til en integrasjon

Utskrift

Automatisering

Konto

Søk og dashboard

API og hendelser

Opprett et API-token

Hvor du finner det

Listen over API-tokens

Opprett et token

Tillatelser

Kopier tokenet (én gang)

Bruk tokenet

Slett et token

Relatert

​Hvor du finner det

​Listen over API-tokens

​Opprett et token

​Tillatelser

​Kopier tokenet (én gang)

​Bruk tokenet

​Slett et token

​Relatert

Hvor du finner det

Listen over API-tokens

Opprett et token

Tillatelser

Kopier tokenet (én gang)

Bruk tokenet

Slett et token

Relatert