Webhooks: koble butikken til dine egne systemer

Har du et eget system som skal vite når noen har handlet? Webhooks-appen legger hendelsene fra butikken i en kø du kan hente fra.

Kort svar

Installer Webhooks fra Apper → Oppdag apper. Appen legger hendelsene betalt, kansellert og refundert ordre i en kø. Systemet ditt henter selv fra køen med en API-nøkkel — serveren din trenger verken offentlig adresse eller sertifikat, siden all trafikk går ut fra deg. Hendelsene blir liggende til systemet ditt har kvittert dem ut, så ingenting går tapt om serveren er nede en stund. Nøkkelen kan byttes når som helst. Krever Pro.

Hvordan det virker

De fleste webhook-løsninger sender en forespørsel til serveren din. Det krever at serveren din er tilgjengelig fra internett, med gyldig sertifikat og en åpen adresse.

Her er det snudd: butikken legger hendelsen i en kø, og systemet ditt henter den når det passer. Det betyr:

• Serveren din trenger ingen offentlig adresse.
• Du trenger ikke sertifikat eller brannmuråpninger.
• Er systemet ditt nede, blir hendelsene liggende og hentes senere.

Det gjør oppsettet mye enklere for små systemer — en hjemmeserver, en liten tjeneste, et skript som kjører hvert femte minutt.

Hendelsene

• Ordre betalt — når betalingen er gjennomført.
• Ordre kansellert
• Ordre refundert

Det dekker det som betyr noe for et eksternt system: noen har kjøpt, eller kjøpet er gjort om.

Sett det opp

1. Installer Webhooks under Apper → Oppdag apper.
2. Opprett et endepunkt og velg bruksområde.
3. Kopier API-nøkkelen. Den identifiserer systemet ditt mot køen.
4. La systemet ditt hente hendelser med nøkkelen, og kvittere ut de det har behandlet.

Hver endepunkt har sin egen nøkkel, og du kan bytte den når som helst — for eksempel hvis den har kommet på avveie.

Et konkret eksempel

Selger du ranger eller tilgang til en Minecraft-server? Serveren kan hente køen med jevne mellomrom, se hvilke ordrer som er betalt, og dele ut rangen automatisk. Kunden får det de kjøpte uten at du gjør noe.

Samme mønster passer for alt annet der et kjøp skal utløse noe i et system du eier: tilgang til noe, en beskjed videre, en oppdatering i et regneark.

Kvitter ut det du har behandlet

En hendelse blir liggende i køen til systemet ditt sier fra at den er behandlet. Det er dette som gjør at ingenting går tapt — men det betyr også at du må kvittere ut, ellers vokser køen.

Bygg det inn fra start: hent, gjør jobben, kvitter ut.

Behandle nøkkelen som et passord

API-nøkkelen gir tilgang til ordredata — hva som er kjøpt, av hvem. Legg den i miljøvariabler, ikke i kode du deler, og bytt den hvis du er i tvil.

Se Personvern og GDPR for nettbutikk.

Vanlige spørsmål