Finn eller opprett en API-nøkkel

For integrasjoner med eksterne systemer som Shipmondo, E-conomic, Klaviyo og andre må du bruke et API-token fra Shoporama. Her finner du dem, og lærer hvordan forbruksgrensene fungerer.

Finn API-tokenene dine

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

I Shoporama finnes det ikke én enkelt «API-nøkkel» per nettbutikk, men en liste over tokens, hvor du kan ha flere samtidig, for eksempel én til Shipmondo, én til E-conomic og én til ditt eget skript.

Opprett et nytt API-token

1. Gå til Integrasjoner → API-tilgang
2. Klikk på Opprett token
3. Gi den et beskrivende navn (f.eks. «Shipmondo») og velg tilgangsnivå
4. Det nye tokenet vises og er klart til bruk

API-begrensninger og forbruk

Hvert API-token har en daglig grense for hvor mange forespørsler det kan utføre. Dette beskytter nettbutikken mot en integrasjon som går over styr, og holder forbruket forutsigbart. Nye tokener får som standard en grense på 10 000 forespørsler per døgn, og du kan når som helst øke eller redusere denne selv.

Hva regnes som et anrop?

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

Slik ser du forbruket

På listen under Integrasjoner → API-tilgang kan du se det aktuelle forbruket for hvert token. Hvis du klikker på et token, vises en farget fremdriftslinje (grønn, gul ved 70 %, rød ved 90 %) som viser 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 på påfølgende forespørsler. Klienten må vente til neste døgn, da telleren automatisk nullstilles. Du får én varslings-e-post om dagen når dette skjer, ikke én per blokkert forespørsel, slik at innboksen ikke blir oversvømmet.

Slik øker du grensen

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

Pris per forespørsel

I tillegg til grensene per token har hver butikk en samlet pulje med gratis anrop inkludert i prismodellen:

• Flex: 1 000 anrop per dag inkludert gratis
• Pro: 10 000 anrop per dag inkludert gratis
• Utover dette faktureres 0,01 kr. per ekstra anrop

Kvoten beregnes samlet for alle butikkens tokens. Sjekk alltid prissiden for de aktuelle tallene. Typiske integrasjoner som Shipmondo, E-conomic, Klaviyo og prisovervåkere bruker vanligvis langt under denne grensen i den daglige driften.

Hva brukes et API-token til?

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

• Shipmondo: for å hente ordrer og opprette forsendelser
• E-conomic / Dinero: for å synkronisere bestillinger og fakturaer
• Klaviyo / Heysender: til e-postmarkedsføring
• Egne integrasjoner: 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 forespørsler per rad. Hvis for eksempel hver vare oppdaterer både produkt, lagerbeholdning og pris, kan 500 rader raskt bli 1 500 forespørsler. Sjekk loggen i den eksterne tjenesten, og øk eventuelt tokenets daglige grense hvis du regelmessig har store importoppdrag.

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

Nei. Grensen gjelder kun integrasjoner som bruker et API-token. Kundene dine bruker nettbutikken i nettleseren sin via en vanlig økt, helt utenfor API-et, og de blir aldri påvirket av tokenforbruket.

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

Flex inkluderer 1 000 gratis forespørsler per dag, mens Pro inkluderer 10 000. Dette er en samlet kvote som gjelder for alle butikkens token. Forespørsler utover dette koster 0,01 kr. per stk. Du setter selv grensen per token, uavhengig av prismodell.

Hvordan ser jeg i regnskapet hvor mange ekstra forespørsler jeg har betalt for?

Ekstra API-anrop utover den inkluderte kvoten beregnes per måned og vises som en egen linje på din månedlige Shoporama-faktura. Dette er skilt fra abonnementet, slik at du tydelig kan se forbruket i regnskapet.

Hvor finner jeg ut hvilken token som bruker mest?

På listen under API-tilgang kan du sortere etter «Daglig forbruk» og se forbruket per token. Det er enklest hvis du har gitt hver integrasjon sin egen token med et beskrivende navn (f.eks. «Shipmondo», «E-conomic», «Eget skript»).

Kan jeg få beskjed før jeg når grensen?

Du får en e-post den dagen grensen nås (én per dag, ikke per blokkert forespørsel). Hvis du ønsker et tidligere varsel, kan du følge med på fremdriftslinjen på tokensiden. Den skifter til gul ved 70 % og rød ved 90 %.

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

Gå til Integrasjoner → API-tilgang, klikk på tokenet og øk «Maksimal daglig grense». Lagre. Integrasjonen kan umiddelbart utføre forespørsler igjen. Telleren nullstilles automatisk ved midnatt.

Lagersystemet mitt utfører tusenvis av forespørsler om natten. Er det normalt?

Det kan være normalt ved en full synkronisering, men ofte kan integrasjonen konfigureres til kun å hente endringer siden forrige gang (delta-synkronisering) i stedet for hele lageret. Sjekk innstillingene i lagersystemet eller spør leverandøren om det finnes en «bare endringer»-modus.

Se også: Se webhooks i nettbutikken din.

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