Hva kan du bruke API-et til?
API-et er bygget for administrativ integrasjon – altså flyt av forretningsdata mellom systemene dine. Typiske bruksområder:
-
Ordre og fakturering: hente ordrer, ordrelinjer og leveranser inn i regnskap eller ERP, og oppdatere status tilbake.
-
Kunder: synkronisere kunder og kundegrupper mellom CRM og butikk.
-
Produkter og lager: opprette og oppdatere produkter, priser, plasseringer, lagerbeholdning og lagerjusteringer fra et PIM- eller ERP-system.
-
Innkjøp og leverandører: opprette og følge opp innkjøpsordrer, leverandørprodukter og lageroverføringer.
-
Kampanjer: styre kuponger, rabatter og tilbud automatisk.
-
Innhold: vedlikeholde mapper, kategorier, bilder, filer, blogginnlegg og relasjoner i innholdsarkivet.
-
Webhooks: la eksterne systemer få beskjed automatisk når noe endrer seg, i stedet for å måtte spørre hele tiden.
-
Rapportering: hente ut salgsrapporter og produkthistorikk til BI-verktøy.
Fordeler
-
Automatisering: kutter manuelt dobbeltarbeid mellom butikken og andre systemer.
-
Standardisert og forutsigbart: følger anerkjente REST-prinsipper, slik at de fleste integrasjonsleverandører kjenner mønsteret igjen.
-
Sikker tilgang: hver integrasjon får sin egen API-nøkkel med tokenbasert pålogging, og tokenet utløper jevnlig.
-
Selektiv datahenting: du kan be om akkurat de feltene og relasjonene du trenger, slik at integrasjonene blir raske og lette.
-
Kraftig søk og filtrering: data kan hentes ut med sortering, paginering og filtrering, så store kataloger kan synkroniseres effektivt.
-
Hendelsesdrevet flyt: webhooks gjør at andre systemer kan reagere umiddelbart på endringer, framfor å polle.
-
Interaktiv dokumentasjon: en innebygd Swagger-side beskriver alle endepunkter og lar utviklere prøve dem i nettleseren.
Begrensninger og kvoter
For å beskytte butikken og sikre rettferdig bruk for alle som integrerer, har API-et innebygde grenser. Grensene gjelder per API-nøkkel og per endepunkt:
Tidsvindu- Maks antall forespørsler
Per sekund: 5
Per minutt: 100
Per time: 2 000
Når passer API-et – og når passer det ikke?
Passer godt til
- Synkronisering av ordre, kunder, produkter, lager og innkjøp mellom butikk og ERP/CRM/PIM
- Automatiske jobber som kjører jevnlig (for eksempel hver natt eller hvert kvarter)
- Hendelsesdrevne flyter via webhooks
- Egne rapporter, dashbord og BI-uthentinger
Passer dårlig til
- Levering av produktsider, kategorisider eller bilder til besøkende i nettbutikken
- Sanntids-oppslag som skjer mange ganger i sekundet per besøk
- Kontinuerlig polling for å oppdage endringer
- Offentlig tilgjengelige tjenester uten innlogging