REST API

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 CRUD (opprette, lese, oppdatere, slette) på de fleste ressurser i nettbutikken din.

Dokumentasjon

Full API-dokumentasjon med alle endepunkter, parametere og eksempler finner du i vår interaktive Swagger-dokumentasjon:

Åpne Swagger-dokumentasjonen

Her kan du teste API-kall direkte i nettleseren og se alle tilgjengelige felt og parametere for hver ressurs.

Kom i gang

1. Gå til Innstillinger → API i Shoporama-administrasjonen
2. Opprett en ny API-nøkkel
3. Velg rettigheter for nøkkelen - du kan gi lese- og/eller skrivetilgang til hver ressurs
4. Bruk nøkkelen i Authorisation-headeren i API-kallene dine

Autentisering

Legg til API-nøkkelen din i Authorisation-headeren. Du kan enten sende nøkkelen direkte eller bruke Bearer-formatet:

Authorisation: YOUR-API-KEY # Eller med Bearer: Authorisation: Bearer YOUR-API-KEY

Tilgjengelige ressurser

API-et gir tilgang til følgende ressurser. Alle endepunkter er tilgjengelige under https://dinshop.dk/REST/:

Produkter og katalog

• /product - Produkter (med varianter, bilder, priser, kategorier, ekstra felt)
• /category - Kategorier
• /brand - Merkevarer/varemerker
• /produsent - Produsenter
• /supplier - Leverandører
• /product-label - Produktetiketter
• /profile, /profile-attribute, /profile-attribute-value - Produktprofiler, attributter og verdier

lager

• /stock - Lagerbeholdning og posteringer
• /batch - Lagerpartier

Bestillinger og kunder

• /order - Bestillinger
• /ordre/{id}/opprett etikett - Opprett fraktetikett på ordre
• /order/{id}/download-label - Last ned fraktetikett
• /order-queue - Ordrekø
• /order-label - Bestillingsetiketter
• /order-return - Returer
• /customer - Kunder
• /customer-field - Kundefelt
• /voucher - Rabattkoder og gavekort

Innhold /page - Statiske sider

• /page - Statiske sider
• /blog-post - Blogginnlegg
• /landing-page og /landing-page-item - Landingssider og -elementer
• /menu - Menyer og navigasjon

/newsletter-list - Nyhetsbrev

• /newsletter-list - Nyhetsbrev-lister
• /newsletter-subscriber - Abonnenter
• /newsletter-campaign - Kampanjer

Oppsett - Oppsett

• /shipping - Forsendelsesmetoder
• /payment_gateway - Betalingsmåter
• /country - Land
• /redirect - URL-omdirigeringer
• /webhook - Webhooks

Temafiler

• /theme-file - Lese, opprette, oppdatere og slette filer i temaene dine. Krever at "Tilgang til temafiler" er aktivert på API-nøkkelen

HTTP-metoder

• GET - Hent en liste eller en enkelt ressurs
• POST - Opprett en ny ressurs
• PUT - Oppdater en eksisterende ressurs
• DELETE - Slett en ressurs

Eksempler på disse metodene

Hent produkter:

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

Opprett et produkt:

curl -X POST -H "Authorisation: YOUR-API-KEY" \ -H "Content-Type: application/json" \ -d '{"name": "New Product", "price": 199.00}' \ https://dinshop.dk/REST/product

Oppdater lagerbeholdningen:

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

Listeendepunktene støtter følgende spørringsparametere:

• ?limit=25 - antall resultater per side (maks. 100)
• ?offset=0 - hopp over resultater (for personsøking)
• ?search=text - fritekstsøk
• ?fields=navn,pris - begrens returnerte felt
• ?last_modified=2026-01-01 - bare ressurser som er endret etter denne datoen

Webhooks

Du kan opprette webhooks via API-et, slik at systemet ditt automatisk blir varslet når det gjøres endringer. Når du oppretter en webhook, mottar du en hemmelighet som brukes til å verifisere webhook-kall via HMAC.

Svarkoder

• 200 - Vellykket
• 201 - Ressurs opprettet
• 204 - Oppdatering/sletting vellykket
• 400 - Ugyldig forespørsel
• 401 - Ikke autorisert (feil eller manglende API-nøkkel)
• 404 - Ressurs ikke funnet
• 429 - For mange anrop (hastighetsgrense)

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