Zo werkt een webhook
Een webhook draait de richting om. Bij een API vraagt jouw workflow steeds aan een pakket of er iets nieuws is. Bij een webhook stuurt het pakket zelf een bericht naar een adres dat jij opgeeft, zodra er iets gebeurt. GitHub legt dit verschil uit in zijn documentatie over webhooks.
Je stelt een webhook één keer in. Je kiest de gebeurtenis, bijvoorbeeld een nieuwe factuur of een betaalde order, en het adres van je workflow. Bij elke gebeurtenis krijgt de workflow de gegevens meteen binnen en kan hij direct starten.
Waar je op let bij een webhook
Het adres van een webhook is een open deur naar je workflow. Behandel het als een geheim en controleer of een bericht echt van het pakket komt. Veel pakketten ondertekenen hun berichten, zodat je workflow dat kan nagaan.
Houd er ook rekening mee dat een bericht soms twee keer komt, of een keer helemaal wegblijft. Laat je workflow een dubbel bericht herkennen, zodat een order niet twee keer wordt geboekt. Controleer daarnaast af en toe of er niets is gemist, bijvoorbeeld met een dagelijkse vraag via de API.
BegripEen API is een vaste manier waarop twee programma's gegevens uitwisselen, bijvoorbeeld je boekhoudpakket en een workflow.