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 hittar du dem och lär dig hur användningsgränserna fungerar.

Hitta dina API-tokens

1. Gå till Integrationer → API-åtkomst (eller direkt till /webshop/api)
2. Här visas en lista över alla token i webbutiken, deras åtkomstnivå, daglig förbrukning och när de senast användes
3. Klicka på en token för att se eller kopiera hela värdet

På Shoporama finns det inte en enda ”API-nyckel” per butik, utan en lista med tokens där du kan ha flera samtidigt, t.ex. en till Shipmondo, en till E-conomic och en till ditt eget skript.

Skapa en ny API-token

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

API-begränsningar och förbrukning

Varje API-token har en daglig gräns för hur många anrop den får göra. Det skyddar webbutiken mot en integration som går överstyr och gör förbrukningen förutsägbar. Nya token får som standard en gräns på 10 000 anrop per dygn, och du kan när som helst höja eller sänka den själv.

Vad räknas som ett anrop?

Ett anrop är en HTTP-förfrågan mot REST-API:et. Om du hämtar en lista med 100 produkter med en enda förfrågan räknas det 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-endpoints (t.ex. /products) istället för att söka per id när det är möjligt.

Så här ser du förbrukningen

I listan under Integrationer → API-åtkomst kan du se den aktuella förbrukningen för varje token. Om du klickar på en token visas en färgad förloppsindikator (grön, gul vid 70 %, röd vid 90 %) som visar hur nära gränsen tokenen ä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 på efterföljande anrop. Klienten måste vänta till nästa dygn, då räknaren automatiskt nollställs. Du får ett meddelande via e-post per dag när detta inträffar, inte ett per blockerad begäran, så din inkorg översvämmas inte.

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

1. Gå till Integrationer → 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 anrop

Utöver gränserna per token har varje butik en sammanlagd pool av gratis anrop som ingår i prismodellen:

• Flex: 1 000 anrop per dag ingår gratis
• Pro: 10 000 anrop per dag ingår gratis
• Utöver detta debiteras 0,01 kr per extra anrop

Poolen räknas samman för alla butikens tokens. Se alltid prissidan för aktuella siffror. Typiska integrationer som Shipmondo, E-conomic, Klaviyo och prisbevakare ligger normalt långt under denna gräns i den dagliga driften.

Vad används en API-token till?

En API-token ger externa system åtkomst att läsa och skriva data i din webbutik via REST-API:et. Typiska integrationer:

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

Vanliga 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 eventuellt tokenets dagliga gräns om du regelbundet har stora importer.

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

Nej. Gränsen gäller endast integrationer som använder en API-token. Dina kunder använder webbutiken i sin webbläsare via en vanlig session, helt utanför API:et, och de påverkas aldrig av tokenförbrukningen.

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

Flex inkluderar 1 000 gratis anrop per dag, Pro inkluderar 10 000. Det är en sammanlagd kvot som gäller för alla butikens token. Anrop utöver detta kostar 0,01 kr per styck. Du bestämmer själv gränsen per token, oberoende av prismodell.

Hur ser jag i redovisningen hur många extra anrop jag har betalat för?

Extra API-anrop utöver den inkluderade kvoten sammanställs per månad och visas som en rad på din månatliga Shoporama-faktura. Det redovisas separat från abonnemanget, så att du tydligt kan se förbrukningen i bokföringen.

Var kan jag se vilken token som förbrukar mest?

I listan under API-åtkomst kan du sortera efter ”Daglig förbrukning” och se förbrukningen per token. Det är enklast om du har gett varje integration en egen token med ett beskrivande namn (t.ex. ”Shipmondo”, ”E-conomic”, ”Eget skript”).

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

Du får ett e-postmeddelande den dag gränsen nås (ett per dag, inte per blockerad begäran). Om du vill ha en tidigare varning, håll koll på förloppsindikatorn på tokensidan. Den blir gul vid 70 % och röd vid 90 %.

Vad gör jag just nu om min integration har stoppats?

Gå till Integrationer → API-åtkomst, klicka på token och höj ”Maximal daglig gräns”. Spara. Integrationen kan omedelbart göra anrop igen. Räknaren nollställs automatiskt vid midnatt.

Mitt lagersystem gör tusentals anrop under natten. Är det normalt?

Det kan vara normalt vid en fullständig synkronisering, men ofta kan integrationen ställas in så att den endast hämtar ändringar sedan senaste synkroniseringen (delta-synkronisering) istället för hela lagret. Kontrollera inställningarna i lagersystemet eller fråga leverantören om det finns ett ”endast ändringar”-läge.

Se även: Se webhooks i din butik.

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