API og webhooks for nettbutikk

For nettbutikker med spesifikke behov er et åpent API den ultimate integrasjonsplattformen — det gir deg friheten til å koble Klis til akkurat de systemene du bruker, på akkurat den måten som passer din virksomhet. Klis tilbyr et fullstendig REST API og et kraftig webhook-system som lar deg bygge sanntidsintegrasjoner uten de begrensningene som følger med ferdige koblinger.

Hva er forskjellen på API og webhooks?

Disse to mekanismene løser ulike problemer, og de brukes gjerne i kombinasjon:

API (pull-modell): Systemet ditt spør Klis om data når du trenger det. Du initierer forespørselen, og Klis svarer med data. Eksempel: Hent alle ordre fra de siste 7 dagene.

Webhooks (push-modell): Klis varsler systemet ditt umiddelbart når noe skjer. Du lytter på en URL du kontrollerer, og Klis sender data dit i sanntid. Eksempel: Klis POSTer ordre-data til ditt system i det sekundet en ordre legges inn.

Klis sitt API: hva kan du gjøre?

Klis sitt REST API gir deg tilgang til alle kjerneressurser i nettbutikken:

• Ordre: Les, opprett, oppdater, kanseller
• Produkter og varianter: Full CRUD-tilgang til produktkatalogen
• Lagerbeholdning: Les og juster lagerstatus per SKU
• Kunder: Les kundeprofiler og kjøpshistorikk
• Betaling: Les transaksjoner og betalingsstatus
• Frakt: Opprett forsendelser og hent sporingsinformasjon
• Rabatter og kampanjer: Les og administrer rabattkoder

Alle endepunkter returnerer JSON, støtter paginering for store datamengder, og er sikret med OAuth 2.0 eller API-nøkler. Se alle integrasjoner for å se hva som kan bygges.

Webhooks i Klis: hendelser du kan lytte på

Klis støtter webhooks for følgende hendelseskategorier:

• order.created — ny ordre bekreftet
• order.updated — ordrestatus endret
• order.cancelled — ordre kansellert
• order.refunded — retur og refusjon behandlet
• product.updated — produkt eller variant endret
• inventory.low — beholdning under terskelverdien du setter
• customer.created — ny kunde registrert
• payment.completed — betaling fullført
• shipment.created — forsendelse opprettet

Webhooks kan konfigureres til én eller flere mottaker-URLer, og Klis sender en signatursheader slik at du kan verifisere at forespørselen faktisk kommer fra Klis.

Bruksscenarioer for egne integrasjoner

Noen eksempler på hva nettbutikker bygger med Klis API:

• ERP-integrasjon: Automatisk synkronisering av ordre, kunder og fakturadata til SAP, Microsoft Dynamics eller lignende
• Egne analyse-dashbords: Hent salgsdata fra Klis API og visualiser i Power BI eller Metabase
• Tilpasset lagersystem: Bygg en plukkliste-app for lagermedarbeidere basert på Klis-ordre
• Prisstyring: Oppdater produktpriser i Klis automatisk fra et sentralt prissettingssystem
• Egendefinert checkout-flyt: Integrer tredjeparts betalingsløsning via Klis API

For regnskap kan ReAI nås via API for egendefinerte regnskapsflyter der standard integrasjoner ikke dekker behovet.

Slik kommer du i gang med Klis API

1. Logg inn i Klis-dashbordet og gå til Innstillinger → API og integrasjoner
2. Generer en API-nøkkel — velg lese-, skrive- eller full tilgang basert på behovet
3. Last ned API-dokumentasjonen fra Klis sin utviklerportal
4. Sett opp en test mot et enkelt endepunkt — for eksempel hent de siste 10 ordrene
5. For webhooks: konfigurer en mottaker-URL og velg hendelsene du vil abonnere på
6. Verifiser webhook-signaturer i din applikasjon for sikkerhet
7. Sett opp feilhåndtering og logging i din integrasjon

For no-code automatisering uten utvikling, se Zapier-integrasjonen . For ferdig pakkede integrasjoner, se lagersystem-integrasjon .

Sikkerhet og beste praksis

• Roter API-nøkler regelmessig: Bruk separate nøkler per integrasjon, og roter ved personellendringer
• Bruk minste nødvendige tilgang: En integrasjon som bare leser ordre, trenger ikke skrivetilgang til produkter
• Valider webhook-signaturer: Bekreft alltid at webhooks kommer fra Klis ved å verifisere den medfølgende signaturen
• Håndter retry-logikk: Webhooks fra Klis retry ved feil — din mottaker-URL må være idempotent
• Overvåk API-bruk: Klis loggfører API-kall — se gjennom loggen jevnlig for uventede mønstre

Vanlige feil

• Rate-limiting ikke håndtert: Klis sitt API har rate-limits per minutt — bygg retry med exponential backoff i klienten din
• Webhook-URL ikke offentlig tilgjengelig: Lokal utviklings-URL (localhost) kan ikke motta webhooks — bruk ngrok eller staging-miljø
• Signatur-validering hoppet over: Uten validering kan hvem som helst sende falske webhooks til systemet ditt
• Paginering ignorert: API-er med mange resultater returnerer kun første side — implementer alltid paginering
• Feil scope på API-nøkkel: Klis returnerer 403-feil hvis nøkkelen mangler nødvendig tilgang — sjekk scope i dashbordet
• Ingen feillogging: Uten logging oppdager du ikke brutte integrasjoner — legg alltid til strukturert feillogging