Shoporama som headless backend
Headless commerce adskiller frontend fra backend. I stedet for at bruge Shoporamas indbyggede temaer, bygger du din egen frontend — en React-app, en Next.js-site, en mobilapp eller noget helt fjerde — og lader Shoporama håndtere alt det tunge: produktstyring, ordrehåndtering, lagerstyring, betalinger og kundedatabase.
Det giver dig total designfrihed uden at give afkald på en gennemprøvet e-handelsmotor med alle de funktioner, du har brug for.
Headless API til din egen butiksfront
REST API'et nedenfor er til integrationer og kræver en API-nøgle. Til selve butiksfronten, som kunderne bruger i browseren eller i en app, har hver webshop et headless API på sin egen adresse, fx https://din-shop.dk/api. Det giver katalog, menuer, Sidedesignerens blokke, kurv, rabatkoder, checkout, betaling og kundekonto, og shoppens egne regler for priser, lager, fragt og betaling gælder hele vejen.
Shoporamas tema Washington er bygget på netop det API, så du kan se et komplet eksempel. Kom i gang med Byg din egen butiksfront på Shoporamas headless API, find alle felter i dokumentationen til headless API'et, og se Washington-temaet.
OAuth-login
Shoporama fungerer som OAuth-server, hvilket betyder at tredjepartsapplikationer kan bede om adgang til en webshop via et sikkert login-flow:
- Din applikation sender brugeren til Shoporamas OAuth-loginside med et client_id og en redirect_uri
- Brugeren logger ind med sine Shoporama-credentials
- Brugeren vælger, hvilken webshop der skal gives adgang til, og hvilket adgangsniveau (Læs, Skriv, eller Fuld)
- Shoporama redirecter tilbage til din app med en API-token og metadata om webshoppen
Ved redirect modtager din app:
- API-token til REST API-kald
- Shop-URL og shopnavn
- API-endpoint
- Valuta og momsinformation
- Om priser er inkl. eller ekskl. moms
- Webshop-ID og adgangsniveau
REST API med 25+ endpoints
Shoporamas REST API giver fuld adgang til alle centrale dele af webshoppen:
- Produkter — Opret, opdater, slet og hent produkter med alle felter
- Kategorier — Administrer kategorihierarkiet
- Ordrer — Hent ordrer, opdater status, administrer ordrekøen
- Kunder — Opret og opdater kundedata
- Lager — Juster lagerbeholdning
- Batches — Administrer batch-/lotnumre
- Leverandører, mærker og producenter — Stamdata til produkter
- Produktprofiler og attributter — Administrer varianter og størrelsessystemer
- Gavekort — Opret og administrer gavekort
- Returneringer — Håndter ordrereturnering
- Fragt — Hent fragtmuligheder
- Betalingsgateways — Hent konfigurerede gateways
- Sider og blogindlæg — Administrer indhold
- Redirects — Administrer URL-redirects
- Menuer — Administrer webshoppen menuer
- Landing pages — Opret og opdater landing pages
- Webhooks — Administrer webhooks programmatisk
- Nyhedsbreve — Administrer nyhedsbrevslister, abonnenter og kampagner
- Labels — Administrer produkt-labels
- Kundefelter — Administrer ekstra kundefelter
Adgangsniveauer
Tokens kan oprettes med tre adgangsniveauer:
- read — Kun læseadgang (GET-requests)
- write — Kun skriveadgang (POST, PUT, DELETE)
- all — Læse- og skriveadgang (GET, POST, PUT, DELETE)
Adgangsniveauet er ikke det eneste loft. En token fra OAuth hører til den bruger, der godkendte forbindelsen, og det samme gælder en nøgle, som en bruger med rollen Udvikler opretter i admin. Har brugeren fået en begrænset rolle i webshoppen, fx Udvikler, Medarbejder, eller Marketing, kan tokenen kun det, rollen må, og andre kald afvises med 403. Fjernes brugeren fra webshoppen, tilbagekaldes tokenen. Læs mere i Roller og rettigheder.
Token-sikkerhed
Shoporama tager token-sikkerhed alvorligt:
- Rate limiting — Automatisk begrænsning af antal forespørgsler for at beskytte mod misbrug
- Brugsstatistik — Detaljeret log over alle API-kald pr. token med metode, endpoint, IP-adresse og user agent
- Automatisk tilbagekald — Fjernes den bruger, der godkendte en OAuth-forbindelse, fra webshoppen, trækkes tokenen automatisk tilbage
- Revocation — Tokens kan til enhver tid trækkes tilbage manuelt
- Last-used tracking — Se hvornår hver token sidst blev brugt
Typiske brugscenarier
- Custom frontend: Byg en React/Next.js-frontend der henter produktdata fra Shoporama
- Mobilapp: Lav en native iOS/Android-app med Shoporama som backend
- ERP-integration: Synkroniser produkter og ordrer med dit ERP-system
- POS-system: Forbind dit fysiske butikssystem med din online webshop
- Marketplace-integration: Push produkter til Amazon, eBay eller andre markedspladser
- Custom apps: Byg apps der udvider Shoporamas funktionalitet