Wat is een webhook en waarom is hij handiger dan opvragen?

Met een API vraagt uw systeem: is dat bericht al aangekomen? Met een webhook wordt het omgedraaid — er wordt naar u gemeld zodra er iets verandert.

Waarom dat beter is

Zonder webhook moet u blijven vragen. Vraagt u elke minuut, dan doet u honderden nutteloze oproepen voor elke die iets oplevert. Vraagt u elk uur, dan weet u het te laat.

Wat u nodig hebt

Een adres op uw eigen server dat een bericht kan ontvangen, en dat altijd bereikbaar is. Dat laatste is het punt dat men onderschat: staat uw server even uit, dan mist u de melding.

Twee dingen die u meteen goed doet

Antwoord snel — verwerk het bericht daarna, niet ervoor. Een trage bevestiging leidt tot herhaalde pogingen.

Verwacht dubbels. Bij een netwerkprobleem kan dezelfde melding twee keer toekomen. Zorg dat uw verwerking daar tegen kan, bijvoorbeeld door het bericht-id te onthouden.

Waarvoor u ze gebruikt

Afleverstatussen en binnenkomende antwoorden. Precies de twee dingen waarvan u wilt weten zodra ze gebeuren.