Hopp til innhold
Dokumentasjonsmeny

Webhooks

Push hendelser til systemene deres: abonnementer, hendelseskatalogen, signeringshemmeligheter, testleveranser og leveringsloggen.

Abonnementer

Innstillinger → Webhooks pusher hendelser til endepunktene deres når de skjer. Et abonnement kobler en mål-URL — kun offentlig HTTPS — med hendelsestypene det vil ha:

stock.changed · item.created · item.updated · movement.created · po.received · count.completed · low-stock · export.completed

Endepunkter og hendelsene de abonnerer på.

Opprettelsen viser signeringshemmeligheten én gang — lagre den som et passord; roter hemmelighet senere uten å gjenskape abonnementet.

URL pluss hendelsestyper; hemmeligheten vises én gang.

Leveranser

Levering er minst-én-gang med nye forsøk og en feilkø-tilstand: mottakere må være idempotente (dedupliser på hendelses-ID) og bør verifisere HMAC-signaturen på rå meldingskropp før noe stoles på — mottakersidens detaljer bor i utviklerveiledningen for webhooks.

Testleveranse sender en eksempelhendelse til endepunktet, og leveringsloggen viser hvert forsøk med status og svar; replay sender en leveranse på nytt etter at mottakssiden er rettet. Ved nedetid hos endepunktet er loggen pluss replay gjenopprettingshistorien deres.

Webhooks krever integrasjonsfunksjonen og webhook-tilgangene; forvaltning av abonnementer revisjonsføres. For pull-basert integrasjon i stedet for push serverer API-ets hendelsesstrøm de samme hendelsene på en markør.