Hurtigstart for REST API

REST API-et lar dine egne systemer jobbe direkte med Zippendo, slik at nettbutikken, ERP-systemet eller lagersystemet ditt kan opprette sendinger, lese ordrer og hente fraktetiketter uten at noen åpner appen. Hvert offentlige endepunkt står i fanen API-referanse, med en lekeplass der du kan prøve forespørsler.

1. Opprett et API-token

Åpne API-innstillinger

I app.zippendo.com åpner du organisasjonsmenyen nederst i sidefeltet, klikker på Administrer, og deretter på API-innstillinger.

Opprett et token

Klikk på Legg til API-token, gi det et navn (for eksempel Production WMS), kryss av for Tillatelser det trenger, og klikk på Opprett token. Kopier tokenet med en gang: det vises bare én gang.

Lagre det trygt

API-tokens starter med zipp_. Behandle dem som passord: ha dem i miljøvariabler, aldri i kildekontroll.

Se API-innstillinger for tillatelser, utløp, begrensning til merkevare og sletting av tokens.

2. Finn organisasjons-ID-en din

Hvert endepunkt tar organisasjons-ID-en din (orgId) i stien. Spør Zippendo hvilken organisasjon tokenet ditt tilhører:

curl -X POST https://api.zippendo.com/api-tokens/verify \
  -H "Content-Type: application/json" \
  -d '{ "token": "zipp_YOUR_TOKEN" }'

Svaret inneholder orgId, sammen med scopes og expiresAt for tokenet.

3. Send din første forespørsel

Send tokenet som en Bearer-legitimasjon i hver forespørsel:

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

Erstatt {orgId} med ID-en fra trinn 2. Tokenet trenger tillatelsen read:shipments for dette kallet.

Legg aldri API-tokens i kode som kjører i en nettleser eller en mobilapp. Kall Zippendo fra backend.

Foretrekker du en typet klient? Gratis SDK-er for TypeScript, Python, PHP, Go og Ruby dekker alle endepunkter, så du slipper rå HTTP.

Hver plan har et budsjett for forespørsler per minutt. Se Grenser for forespørsler.

4. Utforsk endepunktene

Det offentlige API-et dekker:

Område	Typisk bruk
Sendinger	Opprette, sende, dele opp og spore sendinger. Hente fraktetiketter og dokumenter
Ordrer	Opprette ordrer og lese ordrene ordrekanalene dine har importert
Ordrekanaler	Administrere egendefinerte kanaler for din egen nettbutikk eller ERP
Transportører	Koble til transportører, liste fraktproduktene deres og slå opp hentesteder
Fraktpristilbud	Priser fra fraktreglene dine for en handlekurv i kassen
Fraktregler	Lese og administrere fraktregler
Webhooks	Få beskjed når sendinger, ordrer og sporing endres
Adresser	Administrere avsender-, hente- og returadresser

Åpne API-referansen for å bla gjennom stier og forespørselsinnhold, og for å prøve forespørsler på lekeplassen.

Neste steg

Webhooks - hurtigstart

Send hendelser til serveren din når data endres.

Fraktpristilbud

Vis fraktpriser for en handlekurv i kassen.

MCP-server

La Claude, Cursor eller ChatGPT jobbe i Zippendo for deg.

Egendefinerte kanaler

Send ordrer fra din egen nettbutikk eller ERP til Zippendo.

Start

Hurtigstarter

Sendingsflyt

Tilkoblinger

Drift

Organisasjon og konto

Hurtigstart for REST API

1. Opprett et API-token

2. Finn organisasjons-ID-en din

3. Send din første forespørsel

4. Utforsk endepunktene

Neste steg

Webhooks - hurtigstart

Fraktpristilbud

MCP-server

Egendefinerte kanaler

​1. Opprett et API-token

​2. Finn organisasjons-ID-en din

​3. Send din første forespørsel

​4. Utforsk endepunktene

​Neste steg

Webhooks - hurtigstart

Fraktpristilbud

MCP-server

Egendefinerte kanaler

1. Opprett et API-token

2. Finn organisasjons-ID-en din

3. Send din første forespørsel

4. Utforsk endepunktene

Neste steg