Finn eller opprett en API-nøkkel

For integrasjoner med eksterne systemer som Shipmondo, E-conomic, Klaviyo og andre, trenger du et API-token fra Shoporama. Her kan du finne dem og lære hvordan forbruksgrensene fungerer.

Finn API-tokenene dine

1. Gå til Konto → Nettbutikk → API-tilgang (eller direkte til /webshop/api)
2. Her ser du en liste over alle tokens i nettbutikken, deres tilgangsnivå, daglig bruk og når de sist ble brukt
3. Klikk på et token for å se eller kopiere hele verdien

I Shoporama er det ikke én "API-nøkkel" per butikk, men en liste med tokener der du kan ha flere parallelt, f.eks. én for Shipmondo, én for E-conomic og én for ditt eget skript.

Opprett et nytt API-token

1. Gå til Konto → Nettbutikk → API-tilgang
2. Klikk på Opprett nytt token
3. Gi det et beskrivende navn (f.eks. "Shipmondo") og velg tilgangsnivå
4. Det nye tokenet vises og er klart til bruk

API-grenser og bruk

Hvert API-token har en daglig grense for hvor mange anrop det kan foreta. Dette beskytter butikken mot en løpsk integrasjon og holder forbruket forutsigbart. Nye tokener har som standard en grense på 10 000 anrop per dag, og du kan når som helst selv heve eller senke denne grensen.

Hva teller som et anrop?

Et anrop er en HTTP-forespørsel mot REST API. Å hente en liste med 100 produkter med én forespørsel teller som ett anrop, men returnerer 100 produkter. Hvis du henter dem ett om gangen, teller det som 100 anrop. Bruk derfor listeendepunkter (f.eks. /products) i stedet for å søke opp per ID når det er mulig.

Slik ser du forbruket

I listen under Konto → Nettbutikk → API-tilgang kan du se den nåværende bruken for hvert token. Hvis du klikker på et token, viser en farget fremdriftslinje (grønn, gul ved 70 %, rød ved 90 %) hvor nær grensen tokenet er.

Hva skjer hvis grensen nås?

Når et token når sin daglige grense, svarer API-et med HTTP 429 Too Many Requests ved påfølgende anrop. Klienten må vente til neste døgn, da telleren nullstilles automatisk. Du får én e-postmelding per dag når dette skjer, ikke én per blokkert forespørsel, slik at innboksen din ikke oversvømmes.

Slik hever du grensen

1. Gå til Konto → Nettbutikk → API-tilgang
2. Klikk på tokenet du ønsker å endre
3. Skriv inn en ny verdi i feltet Maksimal daglig grense (justeres i trinn på 100)
4. Klikk på Lagre

Prising for anrop

I tillegg til grensene per token, har hver butikk en total mengde gratis samtaler som er inkludert i prismodellen:

• Flex: 1 000 samtaler per dag inkludert gratis
• Pro: 10 000 samtaler per dag inkludert gratis
• Over dette belastes 0,01 euro per ekstra samtale

Samtalegruppen regnes på tvers av alle butikkens tokens samlet. Sjekk alltid prissiden for å se de gjeldende tallene. Typiske integrasjoner som Shipmondo, E-conomic, Klaviyo og prisovervåkere bruker vanligvis langt under denne grensen i daglig drift.

Hva brukes et API-token til?

Et API-token gir eksterne systemer tilgang til å lese og skrive data i butikken din via REST API. Typiske integrasjoner:

• Shipmondo: for å hente ordrer og opprette forsendelser
• E-conomic / Dinero: for å synkronisere bestillinger og fakturaer
• Klaviyo / Heysender: for e-postmarkedsføring
• Egendefinerte integrasjoner: for å hente produkter, bestillinger og kundedata

Ofte stilte spørsmål

Hvorfor nådde jeg plutselig grensen etter en CSV-import?

En import via en integrasjon kan utløse mange anrop per rad. Hvis hver vare for eksempel oppdaterer både produkt, lager og pris, kan 500 rader fort bli til 1500 anrop. Sjekk loggen i den eksterne tjenesten, og øk tokenets daglige grense hvis du regelmessig har store importer.

Får kundene mine også 429-feil i butikken?

Nei, det vil de ikke. Grensen gjelder bare for integrasjoner som bruker et API-token. Kundene dine bruker butikken i nettleseren via en vanlig økt, helt utenfor API-et, og de påvirkes aldri av tokenbruken.

Hva er forskjellen mellom Flex og Pro når det gjelder API-et?

Flex inkluderer 1 000 gratis anrop per dag, Pro inkluderer 10 000. Dette er en total sum for alle butikkens tokens. Samtaler utover dette koster 0,01 euro per stykk. Du setter selv grensen per token, uavhengig av prismodell.

Hvordan ser jeg hvor mange ekstra anrop jeg har betalt for på fakturaen?

Ekstra API-anrop utover den inkluderte poolen beregnes per måned og vises som en linjepost på den månedlige Shoporama-fakturaen. Det er adskilt fra abonnementet, slik at du tydelig kan se bruken i regnskapet.

Hvor kan jeg finne ut hvilket token som brukes mest?

I listen under API-tilgang kan du sortere etter "Daglig bruk" og se bruken per token. Dette er enklest hvis du har gitt hver integrasjon sitt eget token med et meningsfylt navn (f.eks. "Shipmondo", "E-conomic", "Eget script").

Kan jeg bli varslet før jeg når grensen?

Du vil motta en e-post den dagen grensen nås (én per dag, ikke per blokkert forespørsel). Hvis du vil ha et tidligere varsel, kan du følge med på fremdriftslinjen på token-siden. Den skifter til gult ved 70 % og rødt ved 90 %.

Hva gjør jeg nå hvis integrasjonen min har stoppet?

Gå til Konto → Nettbutikk → API-tilgang, klikk på tokenet og hev "Maksimal daglig grense". Lagre. Integrasjonen kan umiddelbart foreta anrop igjen. Telleren tilbakestilles automatisk på slutten av dagen.

Lagersystemet mitt foretar tusenvis av anrop om natten. Er dette normalt?

Det kan være normalt ved full synkronisering, men ofte kan integrasjonen være innstilt slik at den bare henter endringer siden sist (delta-synkronisering) i stedet for hele lagerbeholdningen. Sjekk innstillingene i lagersystemet, eller spør leverandøren din om det finnes en modus for "kun endringer".

Se også: Se webhooks i butikken din.

Trenger du hjelp? Kontakt oss på support@shoporama.dk.