Find or create an API key

Til integrationer med eksterne systemer som Shipmondo, E-conomic, Klaviyo og andre skal du bruge en API-token fra Shoporama. Her finder du dem, og lærer hvordan grænserne for forbrug virker.

Find dine API-tokens

1. Gå til Konto → Webshop → API-adgang (eller direkte til /webshop/api)
2. Her vises en liste over alle tokens på shoppen, deres adgangsniveau, daglige forbrug og hvornår de sidst er brugt
3. Klik på en token for at se eller kopiere den fulde værdi

På Shoporama findes der ikke én enkelt "API-nøgle" pr. shop, men en liste af tokens, hvor du kan have flere parallelt, fx en til Shipmondo, en til E-conomic og en til dit eget script.

Opret en ny API-token

1. Gå til Konto → Webshop → API-adgang
2. Klik Opret ny token
3. Giv den et sigende navn (fx "Shipmondo") og vælg adgangsniveau
4. Den nye token vises og er klar til brug

API-grænser og forbrug

Hver API-token har en daglig grænse for hvor mange kald den må lave. Det beskytter shoppen mod en integration der løber løbsk, og holder forbruget forudsigeligt. Nye tokens får som standard en grænse på 10.000 kald i døgnet, og du kan til enhver tid hæve eller sænke den selv.

Hvad tæller som et kald?

Et kald er ét HTTP-request mod REST-API'et. Henter du en liste over 100 produkter med ét request, tæller det som ét kald, men returnerer 100 produkter. Henter du dem ét ad gangen, tæller det 100 kald. Brug derfor list-endpoints (fx /products) i stedet for at slå op pr. id, når det er muligt.

Sådan ser du forbruget

På listen under Konto → Webshop → API-adgang kan du se det aktuelle forbrug for hver token. Klikker du ind på en token, vises en farvet progress-bar (grøn, gul ved 70%, rød ved 90%) der viser hvor tæt på grænsen tokenen er.

Hvad sker der hvis grænsen rammes?

Når en token når sin daglige grænse, svarer API'et med HTTP 429 Too Many Requests på efterfølgende kald. Klienten skal vente til næste døgn, hvor tælleren automatisk nulstilles. Du får én notifikationsmail om dagen når det sker, ikke én pr. blokeret request, så indbakken bliver ikke oversvømmet.

Sådan hæver du grænsen

1. Gå til Konto → Webshop → API-adgang
2. Klik på den token du vil ændre
3. Indtast en ny værdi i feltet Maksimal daglig grænse (justeres i spring af 100)
4. Klik Gem

Pristering for kald

På toppen af de per-token-grænser har hver shop en samlet pulje af gratis kald inkluderet i sin prismodel:

• Flex: 1.000 kald pr. dag inkluderet gratis
• Pro: 10.000 kald pr. dag inkluderet gratis
• Derover faktureres 0,01 kr. pr. ekstra kald

Puljen tælles på tværs af alle shoppens tokens tilsammen. Se altid prissiden for de aktuelle tal. Typiske integrationer som Shipmondo, E-conomic, Klaviyo og prisvogtere bruger normalt langt under denne grænse i daglig drift.

Hvad bruges en API-token til?

En API-token giver eksterne systemer adgang til at læse og skrive data i din shop via REST API'et. Typiske integrationer:

• Shipmondo: til at hente ordrer og oprette forsendelser
• E-conomic / Dinero: til at synkronisere ordrer og fakturaer
• Klaviyo / Heysender: til email marketing
• Egne integrationer: hent produkter, ordrer og kundedata

Ofte stillede spørgsmål

Hvorfor ramte jeg pludselig grænsen efter en CSV-import?

En import via en integration kan udløse mange kald pr. række. Hvis fx hver vare opdaterer både produkt, lager og pris, kan 500 rækker hurtigt blive 1.500 kald. Tjek loggen i den eksterne tjeneste, og hæv evt. tokenens daglige grænse hvis du regelmæssigt har store imports.

Får mine kunder også 429-fejl på shoppen?

Nej. Grænsen gælder kun integrationer der bruger en API-token. Dine kunder bruger shoppen i deres browser via en almindelig session, helt uden for API'et, og de bliver aldrig påvirket af tokenens forbrug.

Hvad er forskellen på Flex og Pro når det gælder API?

Flex inkluderer 1.000 gratis kald pr. dag, Pro inkluderer 10.000. Det er en samlet pulje på tværs af alle shoppens tokens. Kald derover koster 0,01 kr. pr. styk. Selve per-token-grænsen sætter du selv, uafhængigt af prismodel.

Hvordan ser jeg på regnskabet hvor mange ekstra kald jeg har betalt for?

Ekstra API-kald ud over den inkluderede pulje opgøres pr. måned og fremgår som en linje på din månedlige Shoporama-faktura. Det er adskilt fra abonnementet, så du tydeligt kan se forbruget i bogholderiet.

Hvor finder jeg ud af hvilken token der bruger mest?

På listen under API-adgang kan du sortere på "Dagligt forbrug" og se forbruget pr. token. Det er nemmest hvis du har givet hver integration sin egen token med et sigende navn (fx "Shipmondo", "E-conomic", "Eget script").

Kan jeg få besked før jeg rammer grænsen?

Du får en email den dag grænsen rammes (én pr. dag, ikke pr. blokeret request). Vil du have et tidligere varsel, så hold øje med progress-baren på token-siden. Den skifter til gul ved 70% og rød ved 90%.

Hvad gør jeg lige nu hvis min integration er stoppet?

Gå til Konto → Webshop → API-adgang, klik på tokenen, og hæv "Maksimal daglig grænse". Gem. Integrationen kan straks lave kald igen. Tælleren nulstilles automatisk ved døgnskifte.

Mit lagersystem laver tusindvis af kald om natten. Er det normalt?

Det kan være normalt for en fuld synkronisering, men ofte kan integrationen sættes til kun at hente ændringer siden sidst (delta-sync) i stedet for hele lageret. Tjek indstillingerne i lagersystemet eller spørg leverandøren om der findes en "kun ændringer"-tilstand.

Se også: Se webhooks i din shop.

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