API's en webhooks

Zodra mensen de woorden "API" en "webhook" horen, klappen ze een beetje dicht. Het voelt als iets dat alleen developers begrijpen, een geheime taal waar jij niet bij hoort. Dat gevoel is onterecht, want het zijn eigenlijk twee heel simpele ideeën. Stel je een restaurant voor. Jij zit aan tafel en wil iets bestellen. Je loopt niet zelf de keuken in om je bord te pakken. Je geeft je bestelling door aan de ober, de ober brengt die naar de keuken, en de keuken stuurt via de ober een bord terug. Dat hele proces, een vraag op een vaste, afgesproken manier stellen en een antwoord op een vaste manier terugkrijgen, dat is precies wat een API is.

Een API is de ober tussen jouw systeem en een ander systeem, zoals een database, een CRM of een agenda-tool. Jij vraagt iets, op de manier die zij verwachten, en zij geven iets terug, op de manier die jij kan lezen. Een webhook is het tegenovergestelde, maar even simpel. Stel je staat in dat restaurant te wachten op een tafel, en je loopt om de vijf minuten naar de balie om te vragen of je tafel al vrij is. Dat is vermoeiend, en voor een systeem ook onnodig zwaar. Een webhook is wanneer het restaurant jou actief belt zodra je tafel klaar is. Jij hoeft niks te checken, je wordt vanzelf aangetikt op het moment dat er iets gebeurt. Dat is precies wat een webhook doet tussen twee systemen: in plaats van steeds te vragen "is er al iets nieuws", tikt het andere systeem jou aan op het exacte moment dat er iets verandert.

Zo ziet dat er in het echt ongeveer uit, zonder poespas. Een webhook die binnenkomt nadat iemand een formulier heeft ingevuld, bevat gewoon de gegevens die net zijn ingevoerd: naam Jan, e-mail jan@bedrijf.nl, vraag "ik wil graag een afspraak". Een API-aanvraag om die persoon op te slaan in een database, stuurt diezelfde gegevens door, maar dan in het format dat die specifieke database verwacht. Het ziet er misschien onwennig uit als je het voor het eerst tegenkomt, maar het is in de kern niets meer dan een lijstje van naam en waarde, netjes onder elkaar. Geen geheime code, gewoon dezelfde informatie die je al kende, in een andere jas. Zet die twee bij elkaar en je krijgt een heel normale flow. Iemand vult een formulier in. Dat formulier stuurt direct een webhook, het tikt je systeem aan: er is iets nieuws.

Je systeem roept vervolgens een API aan om die persoon op te slaan in een database. Daarna roept het een API aan bij Claude om een persoonlijk bericht te laten schrijven. En als laatste roept het een API aan bij Telegram om de verkoper een seintje te geven. Vier simpele stappen, twee soorten verbindingen: eentje die jou aantikt, en een paar waar jij zelf iets aanvraagt. De praktische conclusie: vanaf nu, als je leest dat een tool "een webhook heeft" of "een API heeft", weet je precies wat dat betekent. Webhook betekent: zij tikken jou aan zodra er iets gebeurt. API betekent: jij vraagt iets aan hen, en zij geven antwoord. Dat is alles wat je nodig hebt om die woorden nooit meer eng te vinden.