REST API (hodeløs)

Oversikt over Shoporama

Shoporamas REST API lar deg integrere nettbutikken din med eksterne systemer - ERP, lagerstyring, PIM, CRM og andre tjenester. API-et støtter full CRUD (opprette, lese, oppdatere, slette) på de fleste ressurser.

Kom i gang

1. Gå til Innstillinger → API i Shoporama-administrasjonen
2. Opprett en ny API-nøkkel
3. Velg rettigheter: Lese-, skrive- eller full tilgang
4. Bruk nøkkelen i autorisasjonsoverskriften

Autentisering

Legg til API-nøkkelen din i Autorisasjonsoverskriften:

Autorisasjon: DIN-API-NØKKEL

Tilgjengelige ressurser

API-et gir tilgang til følgende ressurser:

Produkter og katalog

• /REST/product - Produkter (med varianter, bilder, priser, kategorier)
• /REST/category - Kategorier
• /REST/brand - Varemerker
• /REST/manufacturer - Produsenter
• /REST/leverandør - Leverandører
• /REST/stock - Lagerbeholdning
• /REST/profile / /REST/profile-attribute - Produktprofiler og attributter

Bestillinger og kunder

• /REST/order - Bestillinger
• /REST/order-return - Returer
• /REST/customer - Kunder
• /REST/voucher - Rabattkoder

Innhold /REST/blog-entry - Blogginnlegg

• /REST/blog-post - Blogginnlegg
• /REST/page - Sider
• /REST/landing-page - Landingssider
• /REST/menu - Navigasjon

Oppsett /REST/setup - Oppsett

• /REST/shipping - Forsendelsesmetoder
• /REST/payment-gateway - Betalingsmåter
• /REST/country - Land
• /REST/redirect - URL-viderekoblinger
• /REST/webhook - Webhooks

HTTP-metoder

Metode	Handling	Eksempel: GET
GET	Hent ressurs(er)	GET /REST/produkt
POST	Opprett ressurs	POST /REST/product
PUT	Oppdater ressurs	PUT /REST/product/123
DELETE	Slett ressurs	DELETE /REST/product/123

Eksempel: Hent produkter

curl -H "Authorisation: YOUR-API-KEY" \ https://dinshop.dk/REST/product?limit=10

Eksempel: Oppdater lagerbeholdning

curl -X PUT -H "Authorisation: YOUR-API-KEY" \ -H "Content-Type: application/json" \ -d '{"stock": 50}' \ https://dinshop.dk/REST/product/123

Filtrering og personsøking

De fleste listeendepunkter støtter:

• ?limit=25 - antall resultater per side (maks. 100)
• ?offset=0 - hopp over et visst antall resultater
• ?search=text - fritekstsøk
• ?fields=name,price - begrens returnerte felt
• ?last_modified=2026-01-01 - bare endret siden dato

Webhooks

Du kan opprette webhooks via API-et, slik at systemet ditt automatisk blir varslet når det skjer endringer:

POST /REST/webhook { "url": "https://dit-system.dk/webhook", "events": ["order", "product", "stock"] } }

Når du oppretter en webhook, vil du motta en hemmelighet som brukes til å verifisere webhook-kall via HMAC.

Begrensning av hastighet

Hver API-nøkkel har en daglig grense for antall anrop. Standardverdien er 10 000 anrop per dag. Hvis grensen overskrides, returneres HTTP 429. Du kan se bruken din og justere grensen under Innstillinger → API.

Svarskoder

• 200 - Vellykket
• 201 - Ressurs opprettet
• 204 - Oppdatering/sletting vellykket
• 400 - Ugyldig forespørsel
• 401 - Ikke autorisert (feil API-nøkkel)
• 404 - Ressurs ikke funnet
• 429 - Takstgrense overskredet

Trenger du hjelp med API-integrasjon? Kontakt oss på support@shoporama.dk.