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

På Shoporama finnes det ikke én enkelt «API-nøkkel» per nettbutikk, men en liste over tokens, hvor du kan ha flere samtidig, for eksempel en til Shipmondo, en til E-conomic og en 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 for anrop

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

• Flex: 1 000 kald 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 daglig drift.

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 bestillinger 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, lager 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 importoperasjoner.

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 anrop per dag, Pro inkluderer 10 000. Dette er en samlet kvote som gjelder for alle butikkens tokener. Anrop utover denne kvoten koster 0,01 kr. per stk. Du setter selv grensen per token, uavhengig av prismodell.

Hvordan ser jeg i regnskapet hvor mange ekstra anrop 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 gult ved 70 % og rødt 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 foreta 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 settes til å hente kun endringer siden forrige gang (delta-synkronisering) i stedet for hele lageret. Sjekk innstillingene i lagersystemet eller spør leverandøren om det finnes en «kun endringer»-modus.

Se også: Se webhooks i nettbutikken din.

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