webhooks: API's en REST
Webhooks zijn een mechanisme dat wordt gebruikt in de wereld van API’s om real-time communicatie tussen systemen mogelijk te maken. In tegenstelling tot traditionele API-aanroepen waarbij een client actief moet vragen om gegevens — een proces dat ook wel polling wordt genoemd — sturen webhooks automatisch informatie zodra er een bepaalde gebeurtenis plaatsvindt. Dit betekent dat een server of service direct een bericht, meestal in JSON-formaat, naar een vooraf gedefinieerd eindpunt (een URL) stuurt wanneer er iets verandert, zoals een nieuwe gebruiker zich registreert, een betaling wordt voltooid of een bestand wordt geüpload. Dit model wordt vaak omschreven als “push-based”, omdat de gegevens worden gepusht van zender naar ontvanger, in plaats van dat de ontvanger ze moet komen halen.
Het concept van webhooks dateert uit 2006 en is voor het eerst voorgesteld door Jeff Lindsay. In 2013 werd dit idee verder geanalyseerd en gereflecteerd in een bron die expliciet terugwijst op Lindsay’s oorspronkelijke voorstel. Het doel van webhooks was om een efficiënter alternatief te bieden voor het continue pollen van API-eindpunten op veranderingen. Pollen is niet alleen traag, maar ook belastend voor netwerken en servers, omdat er constant verzoeken worden gedaan, ook al is er niets veranderd. Webhooks elimineren deze inefficiëntie door alleen te communiceren wanneer er daadwerkelijk iets te melden is. Op die manier worden bronnen bespaard en kan reactietijd op gebeurtenissen sterk worden verkort.
Hoewel webhooks vaak in dezelfde context worden genoemd als REST API’s, zijn ze technisch gezien geen onderdeel van de REST-architectuur. REST, afkorting voor Representational State Transfer, is een architectuurstijl die in 2000 werd geformuleerd door Roy Fielding in zijn proefschrift over architectuur voor gedistribueerde hypermediasystemen. REST definieert een reeks constraints — zoals client-server-structuur, statelessness, cacheability, uniforme interfaces, layered systems en optioneel code-on-demand — die gezamenlijk zorgen voor schaalbare en betrouwbare webdiensten. REST API’s maken gebruik van HTTP-methoden zoals GET, POST, PUT en DELETE om resources op een voorspelbare en standaardiseerbare manier te manipuleren. De kracht van REST ligt in de uniformiteit van de interface en de losse koppeling tussen client en server.
Er bestaat een misvatting dat webhooks een vorm van REST zouden zijn, of zelfs een evolutie ervan, zoals sommige bronnen suggereerden met de term “REST hooks”. Volgens het bronmateriaal is deze term echter misleidend. De bron uit 2013 stelt expliciet dat REST hooks in feite een proprietary variant zijn van webhooks en geen open protocol vormen. Ze concurreren zelfs met het idee van open standaarden, wat in tegenspraak is met de filosofie achter echte REST-architecturen. Webhooks zijn dus geen onderdeel van de REST-architectuur, maar eerder een complementair mechanisme dat los staat van de principes die Fielding heeft geformuleerd. Ze gebruiken vaak HTTP — hetzelfde protocol dat REST API’s gebruikt — maar volgen niet noodzakelijk de constraints zoals uniforme interfaces of statelessness.
Een webhook werkt in de praktijk als volgt: een gebruiker of ontwikkelaar registreert een callback-URL bij een service (bijvoorbeeld een betalingsgateway of een codehostingplatform). Wanneer een vooraf gedefinieerde gebeurtenis zich voordoet — zoals een succesvolle betaling of een nieuwe codecommit — stuurt de service een HTTP POST-verzoek naar die URL, inclusief een payload met details over de gebeurtenis. De ontvanger van deze webhook kan dan automatisch actie ondernemen, zoals het updaten van een database, het activeren van een gebruikersaccount of het starten van een CI/CD-pipeline. Dit maakt webhooks uitermate geschikt voor geautomatiseerde workflows en integraties tussen verschillende systemen.
Toch brengen webhooks ook uitdagingen met zich mee. Omdat ze extern worden aangestuurd, moeten ontvangers veiligheidsmaatregelen nemen om te verifiëren dat de webhook daadwerkelijk afkomstig is van de verwachte bron. Veel diensten bieden daarom authenticatiemechanismen aan, zoals geheime tokens of digitale handtekeningen (bijvoorbeeld HMAC), waarmee de ontvanger de authenticiteit van de payload kan controleren. Daarnaast moet het eindpunt dat de webhook ontvangt, betrouwbaar zijn en fouttolerantie hebben, omdat netwerkproblemen of tijdelijke storingen ertoe kunnen leiden dat berichten verloren gaan. Sommige platforms bieden daarom functies zoals retry-mechanismen of webhook-logboeken om betrouwbaarheid te vergroten.
REST API’s en webhooks kunnen naadloos samenwerken binnen een groter systeem. Een REST API kan bijvoorbeeld worden gebruikt om configuratie-informatie op te halen of acties uit te voeren, terwijl webhooks worden gebruikt om in real-time te reageren op veranderingen. Denk aan een e-commerceplatform dat via een REST API productinformatie beschikbaar stelt, maar via webhooks meldt dat een bestelling is geplaatst. Op die manier blijft de API lichtgewicht en gericht op resources, terwijl de webhook zorgt voor asynchrone communicatie zonder dat de client continu hoeft te pollen.
Roy Fielding, de bedenker van REST, is ook betrokken geweest bij de ontwikkeling van HTTP/1.1 en is medeoprichter van de Apache Foundation. Zijn werk vormt de basis van veel moderne webtechnologieën, waaronder de manier waarop API’s worden ontworpen en geïmplementeerd. Hoewel hij niet betrokken is bij de ontwikkeling van webhooks, is zijn invloed merkbaar in de infrastructuur waarop ze draaien. HTTP, het protocol dat zowel REST API’s als webhooks gebruiken, is een product van de standaardisatie die Fielding en anderen hebben bevorderd.
Het onderscheid tussen webhooks en REST is belangrijk voor ontwikkelaars die schaalbare en onderhoudbare systemen bouwen. REST biedt een robuuste, standaardiseerbare manier om met resources te werken, maar is per definitie request-response: de client vraagt, de server antwoordt. Webhooks daarentegen introduceren een event-driven aanpak, waarbij de server initiatief neemt. Beide modellen hebben hun kracht, en de keuze tussen polling via REST of push via webhooks hangt af van de use case. Voor frequentie van updates, real-time vereisten en efficiëntie is een webhook vaak de betere keuze. Voor betrouwbare, stateless transacties en resourcebeheer blijft REST de gouden standaard.
Samenvattend: webhooks zijn een krachtig hulpmiddel voor real-time integratie tussen systemen, geïntroduceerd door Jeff Lindsay in 2006 als antwoord op de inefficiëntie van polling. Ze zijn geen onderdeel van de REST-architectuur, ondanks soms misleidende termen als “REST hooks”, en worden terecht beschreven als een proprietary aanpak die concurreert met open protocollen. REST, geformuleerd door Roy Fielding in 2000, blijft de dominante architectuurstijl voor webgebaseerde API’s, gebaseerd op duidelijke constraints die schaalbaarheid en uniformiteit waarborgen. Beide technologieën — webhooks en REST — spelen een essentiële rol in moderne softwarearchitecturen, vaak naast elkaar, elk met hun eigen sterktes en toepassingsgebieden.