REST-API

Oversigt

Shoporamas REST API giver dig mulighed for at integrere din webshop med eksterne systemer — ERP, lagerstyring, PIM, CRM og andre tjenester. API'et understøtter CRUD (opret, læs, opdater, slet) på de fleste ressourcer i din webshop.

Dokumentation

Den fulde API-dokumentation med alle endpoints, parametre og eksempler finder du i vores interaktive Swagger-dokumentation:

Åbn Swagger-dokumentationen

Her kan du afprøve API-kald direkte i browseren og se alle tilgængelige felter og parametre for hver ressource.

Kom i gang

1. Gå til Integrationer → API-adgang i din Shoporama-administration
2. Opret en ny API-nøgle
3. Vælg rettigheder for nøglen — du kan give læse- og/eller skriveadgang til hver ressource
4. Brug nøglen i Authorization-headeren på dine API-kald

Autentificering

Tilføj din API-nøgle i Authorization-headeren. Du kan enten sende nøglen direkte eller bruge Bearer-format:

Authorization: DIN-API-NØGLE

# Eller med Bearer:
Authorization: Bearer DIN-API-NØGLE

Tilgængelige ressourcer

API'et giver adgang til følgende ressourcer. Alle endpoints tilgås under https://dinshop.dk/REST/:

Produkter og katalog

• /product — Produkter (med varianter, billeder, priser, kategorier, ekstrafelter)
• /category — Kategorier
• /brand — Brands/varemærker
• /manufacturer — Fabrikanter
• /supplier — Leverandører
• /product-label — Produktlabels
• /profile, /profile-attribute, /profile-attribute-value — Produktprofiler, attributter og værdier

Lager

• /stock — Lagerbeholdning og posteringer
• /batch — Lagerbatches

Ordrer og kunder

• /order — Ordrer
• /order/{id}/create-label — Opret fragtlabel på ordre
• /order/{id}/download-label — Download fragtlabel
• /order-queue — Ordrekø
• /order-label — Ordrelabels
• /order-return — Returneringer
• /customer — Kunder
• /customer-field — Kundefelter
• /voucher — Rabatkoder og gavekort

Indhold

• /page — Statiske sider
• /blog-post — Blogindlæg
• /landing-page og /landing-page-item — Landingssider og elementer. GET /landing-page/{id} returnerer nu sidens regler (rules) og match-type (match_type) direkte i svaret, så du slipper for et separat kald til /landing-page-item
• /menu — Menuer og navigation

Nyhedsbrev

• /newsletter-list — Nyhedsbrevslister
• /newsletter-subscriber — Abonnenter
• /newsletter-campaign — Kampagner

Opsætning

• /shipping — Fragtmetoder
• /payment_gateway — Betalingsmetoder
• /country — Lande
• /redirect — URL-redirects
• /webhook — Webhooks

Tema-filer

• /theme-file — Læs, opret, opdater og slet filer i dine temaer. Kræver at "Adgang til tema-filer" er aktiveret på API-nøglen

HTTP-metoder

• GET — Hent en liste eller en enkelt ressource
• POST — Opret en ny ressource
• PUT — Opdater en eksisterende ressource
• DELETE — Slet en ressource

Eksempler

Hent produkter:

curl -H "Authorization: DIN-API-NØGLE" \
  https://dinshop.dk/REST/product?limit=10

Opret et produkt:

curl -X POST -H "Authorization: DIN-API-NØGLE" \
  -H "Content-Type: application/json" \
  -d '{"name": "Nyt produkt", "price": 199.00}' \
  https://dinshop.dk/REST/product

Opdater lagerbeholdning:

curl -X PUT -H "Authorization: DIN-API-NØGLE" \
  -H "Content-Type: application/json" \
  -d '{"stock": 50}' \
  https://dinshop.dk/REST/product/123

Filtrering og paging

Liste-endpoints understøtter følgende query-parametre:

• ?limit=25 — antal resultater pr. side (max 100)
• ?offset=0 — spring resultater over (til paging)
• ?search=tekst — fritekst-søgning
• ?fields=name,price — begræns returnerede felter
• ?last_modified=2026-01-01 — kun ressourcer ændret siden dato

Webhooks

Du kan oprette webhooks via API'et, så dit system automatisk får besked når der sker ændringer. Ved oprettelse modtager du en secret som bruges til at verificere webhook-kald via HMAC.

Svarkoder

• 200 — Succes
• 201 — Ressource oprettet
• 204 — Opdatering/sletning lykkedes
• 400 — Ugyldig forespørgsel
• 401 — Ikke autoriseret (forkert eller manglende API-nøgle)
• 404 — Ressource ikke fundet
• 429 — For mange kald (rate limit)

Har du brug for hjælp med API-integration? Kontakt os på support@shoporama.dk.