Hitta eller skapa en API-nyckel

För integrationer med externa system som Shipmondo, E-conomic, Klaviyo och andra behöver du en API-token från Shoporama. Här kan du hitta dem och lära dig hur utgiftsgränserna fungerar.

Hitta dina API-tokens

1. Gå till Konto → Online Shop → API-åtkomst (eller direkt till /webshop/api)
2. Här ser du en lista över alla tokens i butiken, deras åtkomstnivå, dagliga användning och när de senast användes
3. Klicka på en token för att visa eller kopiera det fullständiga värdet

I Shoporama finns det inte en enda "API-nyckel" per butik, utan en lista med tokens där du kan ha flera parallellt, t.ex. en för Shipmondo, en för E-conomic och en för ditt eget skript.

Skapa en ny API-token

1. Gå till Konto → Webshop → API-åtkomst
2. Klicka på Skapa ny token
3. Ge den ett beskrivande namn (t.ex. "Shipmondo") och välj åtkomstnivå
4. Den nya token visas och är redo att användas

API-gränser och användning

Varje API-token har en daglig gräns för hur många anrop den kan göra. Detta skyddar butiken från en okontrollerad integration och håller förbrukningen förutsägbar. Nya tokens har som standard en gräns på 10 000 anrop per dag, och du kan själv höja eller sänka den när som helst.

Vad räknas som ett anrop?

Ett anrop är en HTTP-begäran mot REST API. Att hämta en lista med 100 produkter med en begäran räknas som ett anrop, men returnerar 100 produkter. Om du hämtar dem en i taget räknas det som 100 anrop. Använd därför liständpunkter (t.ex. /products) i stället för att leta upp per ID när det är möjligt.

Så här ser du förbrukningen

I listan under Konto → Webshop → API-åtkomst kan du se den aktuella användningen för varje token. Om du klickar på en token visar en färgad förloppsindikator (grön, gul vid 70 %, röd vid 90 %) hur nära gränsen token är.

Vad händer om gränsen nås?

När en token når sin dagliga gräns svarar API:et med HTTP 429 Too Many Requests vid efterföljande anrop. Klienten måste vänta till nästa 24 timmar då räknaren automatiskt återställs. Du får ett e-postmeddelande per dag när detta händer, inte ett per blockerad begäran, så att din inkorg inte översvämmas.

Så här höjer du gränsen

1. Gå till Konto → Onlinebutik → API-åtkomst
2. Klicka på den token du vill ändra
3. Ange ett nytt värde i fältet Maximal daglig gräns (justeras i steg om 100)
4. Klicka på Spara

Prissättning för samtal

Utöver begränsningarna per token har varje butik en total pool av fria samtal som ingår i dess prismodell:

• Flex: 1 000 samtal per dag ingår gratis
• Pro: 10 000 samtal per dag ingår gratis
• Utöver detta debiteras 0,01 € per ytterligare samtal

Poolen räknas över alla butikens tokens tillsammans. Kontrollera alltid prissättningssidan för aktuella siffror. Typiska integrationer som Shipmondo, E-conomic, Klaviyo och prisbevakare använder vanligtvis långt under denna gräns i den dagliga driften.

Vad används en API-token till?

En API-token ger externa system tillgång till att läsa och skriva data i din butik via REST API. Typiska integrationer:

• Shipmondo: för att hämta ordrar och skapa försändelser
• E-conomic / Dinero: för att synkronisera ordrar och fakturor
• Klaviyo / Heysender: för e-postmarknadsföring
• Anpassade integrationer: hämta produkter, beställningar och kunddata

Ofta ställda frågor

Varför nådde jag plötsligt gränsen efter en CSV-import?

En import via en integration kan utlösa många anrop per rad. Om till exempel varje artikel uppdaterar både produkt, lager och pris kan 500 rader snabbt bli 1 500 anrop. Kontrollera loggen i den externa tjänsten och höj tokenens dagliga gräns om ni regelbundet har stora importer.

Får mina kunder också 429-fel i butiken?

Nej, det kommer de inte att göra. Gränsen gäller endast för integrationer som använder en API-token. Dina kunder använder shoppen i sin webbläsare via en vanlig session, helt utanför API:et, och de påverkas aldrig av tokenanvändningen.

Vad är skillnaden mellan Flex och Pro när det gäller API:et?

Flex inkluderar 1 000 gratis samtal per dag, Pro inkluderar 10 000. Detta är en total pool över alla butikens tokens. Samtal utöver det kostar 0,01 € vardera. Du ställer själv in gränsen per token, oavsett prismodell.

Hur ser jag hur många extra anrop jag har betalat för på fakturan?

Ytterligare API-anrop utöver den inkluderade poolen beräknas per månad och visas som en rad på din månatliga Shoporama-faktura. Det är separerat från prenumerationen så att du tydligt kan se användningen i bokföringen.

Var kan jag ta reda på vilken token som används mest?

I listan under API-åtkomst kan du sortera efter "Daglig användning" och se användningen per token. Detta är enklast om du har gett varje integration en egen token med ett meningsfullt namn (t.ex. "Shipmondo", "E-conomic", "Eget script").

Kan jag få ett meddelande innan jag når gränsen?

Du kommer att få ett e-postmeddelande den dag gränsen nås (ett per dag, inte per blockerad begäran). Om du vill ha en tidigare avisering kan du hålla ett öga på förloppsindikatorn på token-sidan. Den blir gul vid 70 % och röd vid 90 %.

Vad gör jag nu om min integration har stannat?

Gå till Konto → Webshop → API-åtkomst, klicka på token och höj "Maximal daglig gräns". Spara sedan. Integrationen kan omedelbart ringa samtal igen. Räknaren återställs automatiskt i slutet av dagen.

Mitt inventeringssystem ringer tusentals samtal på natten. Är detta normalt?

Det kan vara normalt vid en fullständig synkronisering, men ofta kan integrationen vara inställd på att endast hämta förändringar sedan sist (delta-sync) istället för hela lagret. Kontrollera inställningarna i lagringssystemet eller fråga din leverantör om det finns ett läge för "endast ändringar".

Se även: Se webhooks i din shop.

Behöver du hjälp med något? Kontakta oss på support@shoporama.dk.