REST API (Headless)

Översikt över Shoporama

Shoporamas REST API gör att du kan integrera din webbutik med externa system - ERP, lagerhantering, PIM, CRM och andra tjänster. API:et stöder full CRUD (skapa, läsa, uppdatera, radera) på de flesta resurser.

Så här kommer du igång

1. Gå till Inställningar → API i din Shoporama-administration
2. Skapa en ny API-nyckel
3. Välj rättigheter: Läsa, skriva eller fullständig åtkomst
4. Använd nyckeln i auktoriseringshuvudet

Autentisering

Lägg till din API-nyckel i auktoriseringshuvudet:

Auktorisering: DIN-API-KNYCKEL

Tillgängliga resurser

API:et ger tillgång till följande resurser:

Produkter och katalog

• /REST/product - Produkter (med varianter, bilder, priser, kategorier)
• /REST/category - Kategorier
• /REST/varumärke - Varumärken
• /REST/tillverkare - Tillverkare
• /REST/leverantör - Leverantörer
• /REST/stock - Lager
• /REST/profile / /REST/profile-attribute - Produktprofiler och attribut

Beställningar och kunder

• /REST/order - Beställningar
• /REST/order-return - Returer
• /REST/customer - Kunder
• /REST/voucher - Rabattkoder

Innehåll /REST/blog-entry

• /REST/blog-post - Blogginlägg
• /REST/page - Sidor
• /REST/landing-page - Landningssidor
• /REST/menu - Navigering

Uppsättning /REST/setup

• /REST/shipping - Leveransmetoder
• /REST/payment-gateway - Betalningsmetoder
• /REST/country - Länder
• /REST/redirect - Omdirigering av webbadresser
• /REST/webhook - Webhooks

HTTP-metoder

Metod	Åtgärd	Exempel: GET
GET	Hämta resurs(er)	GET /REST/produkt
POST	Skapa resurs	POST /REST/produkt
PUT	Uppdatera resurs	PUT /REST/produkt/123
RADERA	Ta bort resurs	DELETE /REST/produkt/123

Exempel: Hämta produkter

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

Exempel: Uppdatera lager

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

Filtrering och personsökning

De flesta liständpunkter stöder:

• ?limit=25 - antal resultat per sida (max 100)
• ?offset=0 - hoppa över ett antal resultat
• ?search=text - fritextsökning
• ?fields=namn,pris - begränsa returnerade fält
• ?last_modified=2026-01-01 - endast ändrade sedan datum

Webhooks

Du kan skapa webhooks via API:et så att ditt system automatiskt meddelas när ändringar sker:

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

När du skapar en webhook får du en hemlighet som används för att verifiera webhook-anrop via HMAC.

Begränsning av hastighet

Varje API-nyckel har en daglig gräns för antalet anrop. Standardvärdet är 10 000 anrop per dag. Om gränsen överskrids returneras HTTP 429. Du kan se din användning och justera gränsen under Inställningar → API.

Svarskoder

• 200 - Framgång
• 201 - Resurs skapad
• 204 - Uppdatering/radering lyckades
• 400 - Ogiltig begäran
• 401 - Ej behörig (felaktig API-nyckel)
• 404 - Resurs hittades inte
• 429 - Gräns för hastighet överskriden

Behöver du hjälp med API-integration? Kontakta oss på support@shoporama.dk.