feed® Webhooks - Utviklerguide
Hva er webhooks?
Webhooks gjør det mulig å varsle systemet ditt automatisk når produktdata endres
...
, slik at du slipper å gjevnlig spørre. Du oppgir et HTTP-endepunkt som mottar et JSON-kall hver gang et produkt opprettes, oppdateres eller slettes.
...
Slik fungerer det
- En produkthendelse inntreffer (opprettet, oppdatert eller slettet).
- Aktive webhooks sjekkes mot hendelsestype og eventuelle filtre.
- Matchende hendelser samles opp og sendes
...
- ut hvert 30. sekund med ett kall per produkt i dette intervallet.
- En HTTP POST request med JSON-
...
- body sendes til endepunktet ditt.
- Hvis leveringen mislykkes, gjøres det nytt forsøk opptil 3 ganger. Vedvarende feil registreres og kan utløse e-postvarsler.
...
Sette opp en webhook
Gå til Integrasjoner → Webhooks i menyen. Klikk +-knappen nederst til høyre for å opprette en webhook.
Felter
Navn
...
En visningsverdi for å identifisere denne
...
webhooken.
URL Endepunktet på din side som vil motta HTTP POST-kall.
Hendelser Hvilke typer endringer som skal utløse webhookens. Du kan velge én eller flere:
...
Created- et nytt produkt ble lagt til
...
Updated- et produktfelt ble endret
...
- Deleted - et produkt ble slettet
Autentiseringsmetode Hvordan systemet autentiserer seg når det kaller endepunktet ditt. Alternativer:
- None - ingen autentiseringsheader sendes
- Basic - sender en
Authorization: Basic-header; oppgi brukernavn og passord - OAuth2 - henter et token via Client Credentials-flyten før hver levering; oppgi token-URL, klient-ID og klienthemmelighet
E-post for feilvarsel Hvis leveringen gjentatte ganger mislykkes, sendes feilmeldinger til denne adressen .
Aktivering
En webhook må aktiveres eksplisitt før den begynner å sende. Når den er aktiv, er URL, hendelsestyper, autentiseringsinnstillinger og varslings-e-post låst - deaktiver først hvis du trenger å endre dem.
Testing
Bruk Test konfigurasjon-knappen for å sende en eksempelnyttelast til endepunktet ditt umiddelbart. Dialogen viser nyttelasten som vil bli sendt, og svaret endepunktet ditt returnerer. Dette er den enkleste måten å verifisere oppsettet på før aktivering.
...
Filtre
Som standard utløses en webhook ved alle endringer som samsvarer med dens hendelsestyper. Filtre lar deg begrense dette slik at du bare mottar kall for bestemte typer endringer.
For å legge til et filter, åpne webhookens og klikk +-knappen i filterpanelet. Et filter krever et endringsområde - hvilken del av produktdataene som ble endret:
| Endringsområde | Hva det dekker |
|---|---|
| Produkt | Kjerneproduktfelt (navn, status, leverandør osv.) |
| Attributt | Produktattributtverdier |
| Media | Mediefiler lagt til eller fjernet |
| Relasjon | Produktrelasjoner |
| ETIM | ETIM-klasse eller verdiendringer |
| Emballasje | Emballasjedata |
| Struktur | Produktstruktur og hierarki |
| EPD | EPD-data |
| Entitet | Entitetstilknytninger |
For Produkt-endringer kan du i tillegg angi hvilket felt som må ha endret seg (f.eks. kun utløse ved statusendring, ikke navneendring).
For Attributt-endringer kan du angi et bestemt attributt ved navn.
Flere filtre kombineres med OR - en webhook utløses hvis ett av filtrene matcher.
...
Nyttelast
Kallet sendes som POST med Content-Type: application/json. Kroppen ser slik ut:
{ "identifier": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "data": null, "events": [ { "type": "CREATED", "timestamp": "2026-05-10T08:00:00Z" }, { "type": "UPDATED", "field": "NAME", "timestamp": "2026-05-11T14:30:00Z" } ] }
| Felt | Beskrivelse |
|---|---|
identifier | Produktets offentlige ID (UUID). Bruk denne til å hente produktet fra API-et. |
data | Alltid null for øyeblikket. Fullstendige produktdata vil inkluderes i en fremtidig versjon. |
events | Alle hendelser som har skjedd på dette produktet siden forrige levering. Kan inneholde mer enn én. |
events[].type | CREATED, UPDATED eller DELETED |
events[].field | For UPDATED-hendelser på kjerneproduktfelt: én av PRODUCT_NO, ALT_PRODUCT_NO, NAME, ALT_NAME, STATUS_ID, TYPE_ID, OWNER_ID, GROUP_ID, SUPPLIER_ID, BASE_ID, IS_BASE, VARIANTS. Utelates for CREATED/DELETED og for alle andre endringstyper (attributter, media, relasjoner osv.). |
events[].timestamp | ISO-8601-tidsstempel for når hendelsen inntraff. |
Flere hendelser kan samles i ett enkelt kall. Behandle alle oppføringer i
events-arrayen.
Siden data for øyeblikket er null, bør mottakeren bruke identifier til å hente gjeldende produkttilstand fra API-et ved behov.
...
Krav til mottaker
Endepunktet ditt må:
- Svare med HTTP
2xx-status innen 3 sekunder. - Være idempotent - samme hendelse kan leveres mer enn én gang ved nytt forsøk.
...
Feilvarslinger
Hvis levering mislykkes etter alle forsøk, registreres feilen internt. Hvis en
...
e-post adresse for feilvarsel er konfigurert, sendes en oppsummerings-e-post hvert 6. time så lenge det finnes uløste feil. Feilregistreringer beholdes i 14 dager.