Opret et API-token

Et API-token lader dine egne systemer eller en udvikler, der arbejder for dig, forbinde til Zippendo: oprette forsendelser, læse ordrer, registrere webhooks og alt andet i API-referencen. Du opretter tokens under API-indstillinger. Zippendo viser det fulde token kun én gang, lige efter du har oprettet det. Rundtur i Indstillinger: Indstillinger, team og brands. Første forespørgsel: REST API quickstart. Fragtpriser i checkout: Hent et forsendelsestilbud.

Alle planer indeholder API-tokens: Free op til 2, Standard 5, Growth 10, Pro og Enterprise ubegrænset. Ved grænsen mislykkes oprettelsen af et token med Du har nået grænsen for dit abonnement. Opgrader dit abonnement, eller fjern noget, du ikke længere bruger. Slet et token, du ikke længere bruger, eller opgrader.

Hvor du finder det

Åbn organisationsmenuen nederst i sidebjælken, klik på Administrer og derefter på fanen API-indstillinger. Knappen til at oprette et token er Tilføj API-token øverst til højre.

Listen over API-tokens

Kolonne	Hvad den viser
Navn	Det Tokennavn, du indtastede.
Token	De første tegn i tokenet efterfulgt af `...`. Det fulde token vises aldrig her.
Rettigheder	Op til tre rettigheder, såsom Se forsendelser; resten er skjult. Ingen rettigheder, hvis ingen blev valgt.
Sidst brugt	Hvornår tokenet sidst blev brugt, eller Aldrig.
Oprettet af	Det teammedlem, der oprettede det.
Udløber	Udløbsdatoen, eller Aldrig. En dato i fortiden vises med rødt.
Oprettet	Hvornår det blev oprettet.

Det eneste, du kan gøre med et token på listen, er at Slet det. Du kan ikke redigere eller omdøbe et token. Når der endnu ikke er nogen tokens, viser listen Ingen API-tokens og en knap Opret dit første token.

Opret et token

Åbn vinduet

Klik på Tilføj API-token, eller Opret dit første token, når listen er tom. Vinduet Opret API-token åbnes.

Giv tokenet et navn

Udfyld Tokennavn *, for eksempel “Warehouse WMS”. Angiv eventuelt Udløber om (dage) og Begræns til brand.

Vælg rettighederne

Afkryds, hvad tokenet må gøre, eller klik på Vælg alle.

Opret det

Klik på Opret token. Du ser API-token oprettet, og API-token oprettet åbnes med det fulde token.

Vinduet Opret API-token med Tokennavn, Udløber om (dage) og afkrydsningsfelter til rettigheder — Opret API-token: navn, valgfri udløbsdato og derefter rettighederne

Felt	Påkrævet	Det skal du indtaste
Tokennavn *	Ja	Et navn, der fortæller dig, hvor tokenet bruges, såsom “Production API” eller “Webhook Service”. Op til 100 tegn.
Begræns til brand	Nej	Vises kun, hvis din organisation har brands. Vælg et brand, og Apps og systemer, der bruger dette token, kan kun se og ændre dette brands data. Standarden er Intet brand (hele organisationen). Du kan ikke ændre det senere.
Udløber om (dage)	Nej	Et tal fra 1 til 365. Tokenet holder op med at virke efter så mange dage. Lad feltet stå tomt for et token, der aldrig udløber.
Rettigheder *	Ja, mindst én	Hvad tokenet må læse og ændre. Se listen nedenfor.

Opret token forbliver nedtonet, indtil tokenet har et navn og mindst én rettighed.

Rettigheder

Hvert område har en Læs-rettighed (Se og læse information) og en Skriv-rettighed (Oprette, opdatere og slette). En Skriv-rettighed omfatter Læs for samme område.

Rettighed	Dækker
Se forsendelser / Rediger forsendelser	Forsendelser
Se forsendelsesregler / Rediger forsendelsesregler	Forsendelsesregler og fragtpriser
Se transportører / Rediger transportører	Forbundne transportører
Se adresser / Rediger adresser	Afsenderadresser
Se organisationen / Rediger organisationen	Din organisations oplysninger
Se teammedlemmer / Rediger teammedlemmer	Teammedlemmer
Se API-tokens / Rediger API-tokens	Andre API-tokens
Se alt / Rediger alt	Alt ovenfor undtagen API-tokens, plus ordrer, ordrekanaler, printere, webhooks, automatiseringer, integrationer og roller

Ordrer, ordrekanaler, printere, webhooks, automatiseringer og integrationer har ikke en rettighed for sig: et token, der skal bruge dem, skal have Se alt eller Rediger alt. Ingen af dem omfatter API-tokens, så afkryds også Rediger API-tokens, hvis tokenet skal oprette eller slette andre tokens. De samme rettigheder bruges til brugerdefinerede roller.

Kopier tokenet (én gang)

API-token oprettet viser det fulde token, som starter med zipp_. Vinduet advarer: Sørg for at kopiere dette token. Du kan ikke se det igen, når dette vindue lukkes.

Vinduet API-token oprettet med tokenet, en Kopier-knap og en Vigtigt-advarsel — API-token oprettet: kopier tokenet, før du lukker vinduet

Klik på Kopier. Du ser Nøgle kopieret til udklipsholderen. Hvis du ser Kunne ikke kopiere nøglen, så markér tokenet og kopier det i hånden. Luk derefter vinduet. Hvis du mister tokenet, så slet det og opret et nyt.

Behandl tokenet som en adgangskode. Læg det ikke i kode, andre kan se, eller på en webside. Hvis det kommer ud, så slet det (se “Slet et token” nedenfor) og opret et nyt. Forespørgsler, der fejler: Godkendelsesfejl med API-token.

Brug tokenet

Din udvikler sender tokenet med hver forespørgsel:

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

{orgId} er din organisations ID, ikke det navn, der står i appens adresselinje. En udvikler kan hente det med Orgs-forespørgslerne i API-referencen, hvor hver forespørgsel og hvert svar er beskrevet. Færdige klienter: SDK’er. Grænser: Rate limits. Et token uden brand kan rette en enkelt forespørgsel mod ét brand med headeren X-Zippendo-Brand. Et token oprettet med Begræns til brand holder sig altid inden for sit brand. Se Brands.

Slet et token

Klik på Slet på tokenets række. Slet API-token beder dig skrive tokenets navn med store bogstaver, for eksempel WAREHOUSE WMS, og derefter klikke på Slet. Du ser API-tokenet blev slettet. Alle systemer, der bruger tokenet, kan ikke længere forbinde. Sletning kan ikke fortrydes, og der er ingen måde at sætte et token på pause i stedet.

Vinduet Slet API-token med et felt, hvor du skriver navnet for at bekræfte — Slet API-token: skriv navnet med store bogstaver for at bekræfte

Relateret

Webhooks: Zippendo fortæller dit system, når der sker noget, i stedet for at dit system spørger.
Forbind Slack, Klaviyo og andre apps: færdige forbindelser, der ikke kræver et API-token.
API til egen kanal: send ordrer fra din egen shop eller dit eget system ind i Zippendo.
Hent et forsendelsestilbud: fragtpriser i checkout.
MCP-godkendelse: forbind en AI-agent uden at indsætte et token.

Overblik

Forsendelser

Ordrer og ordrekanaler

Transportører

Tilslut en transportør

Tilslut en integration

Udskrivning

Automatisering

Konto

Søgning og dashboard

API og events

Opret et API-token

Hvor du finder det

Listen over API-tokens

Opret et token

Rettigheder

Kopier tokenet (én gang)

Brug tokenet

Slet et token

Relateret

​Hvor du finder det

​Listen over API-tokens

​Opret et token

​Rettigheder

​Kopier tokenet (én gang)

​Brug tokenet

​Slet et token

​Relateret

Hvor du finder det

Listen over API-tokens

Opret et token

Rettigheder

Kopier tokenet (én gang)

Brug tokenet

Slet et token

Relateret