APIs vs. Webhooks

En daar komen API's en Webhooks om de hoek kijken. Helaas worden deze twee termen vandaag de dag nog steeds door mensen door elkaar gebruikt in toolsdocumentatie en technische artikelen, zonder daadwerkelijk te weten hoe verschillend ze zijn. Zowel webhooks als API's hebben een verschillende modus operandi en worden voor verschillende doeleinden gebruikt.

Wat zijn APIs? 

API staat voor Application Programming Interface. In eenvoudige bewoordingen: een reeks regels die het mogelijk maakt dat de ene software communiceert met een andere software. De eerste software roept de API aan door een verzoek om een dienst te sturen. De tweede software levert vervolgens de gevraagde dienst door middel van een respons via de API. De respons kan van alles zijn - een gegevensstuk of een foutmelding.

Hier is een eenvoudige analogie om API's uit te leggen.

“Stel je voor dat je in een restaurant bent. Je wilt eten bestellen. Een manier om dit te doen, is door naar de keuken te gaan en het eten zelf te bereiden. De eenvoudigere manier is om de ober te vertellen wat je wilt eten.

Hier ben jij de eerste software die een dienst (eten) aanvraagt. Het restaurant is de tweede software die je de dienst verleent. De ober is de API die je een manier biedt om de dienst aan te vragen.

De ober neemt je bestelling op, geeft het door aan de chef en brengt je ten slotte het eten zodra het klaar is. Op vergelijkbare wijze stroomlijnen API's de interactie tussen softwaretoepassingen, waardoor het proces van toegang tot en gebruik van diensten die worden aangeboden door andere softwarecomponenten wordt vereenvoudigd.”

Wat zijn webhooks? 

Een webhook is een techniek waarbij een toepassing in real-time informatie aanbiedt aan een andere toepassing wanneer een specifieke gebeurtenis plaatsvindt. Webhooks worden ook wel omgekeerde API's genoemd omdat, in tegenstelling tot API's, de communicatie wordt geïnitieerd door de toepassing die de informatie verzendt in plaats van degene die deze ontvangt. Bijvoorbeeld, je kunt een Webhook gebruiken om je CRM-systeem op de hoogte te stellen wanneer een nieuwe klant zich aanmeldt op je website.

 Laten we Webhooks uitleggen met dezelfde restaurantanalogie.

“Stel je voor dat je in hetzelfde restaurant bent. Je hebt je bestelling geplaatst en je wilt weten of het eten klaar is. Een manier om dit te doen, is constant de ober lastigvallen en vragen of het eten al klaar is. Dit is vergelijkbaar met een API waarbij je constant controleert of een specifieke gebeurtenis heeft plaatsgevonden.

De efficiëntere manier is om je telefoonnummer aan de ober te geven en hem je een bericht te laten sturen zodra het eten klaar is. Dit is vergelijkbaar met een Webhook, waarbij je een manier creëert voor het restaurant om een melding te sturen zodra de gebeurtenis (het eten gereed maken) plaatsvindt.”

Wanneer APIs te gebruiken? 

Hier zijn drie situaties waarin je API's wilt gebruiken:

1. Wanneer je specifieke informatie wilt opvragen van een bepaald systeem.
2. Wanneer je specifieke informatie on demand wilt opvragen (in plaats van realtime).
3. Wanneer je een actie wilt uitvoeren op een ander systeem, zoals het creëren, bijwerken of verwijderen van gegevens.

Hier zijn drie voorbeelden uit real-time waarbij je een API gebruikt: 

1. Je bent bezig met het bouwen van een weer-app. Je wilt deze verbinden met een weer-voorspellingsdienst. Je kunt een API gebruiken om de actuele weergegevens op te vragen voor een specifieke locatie.
2. Je bent bezig met het bouwen van een online winkel. Je wilt deze verbinden met een betalingsverwerkingsoplossing. Je kunt een API gebruiken om de betalingsgegevens in te dienen en de transacties te verwerken.
3. Je bent bezig met het bouwen van een sociaal platform. Je wilt deze verbinden met een vertaaloplossing om automatisch elke post te vertalen. Je kunt een API gebruiken om deze vertalingen on demand op te vragen.

Wanneer gebruik je webhooks? 

Hier zijn drie voorbeeldsituaties waarin je Webhooks zou willen gebruiken:

1. Wanneer je direct op de hoogte wilt worden gesteld zodra een gebeurtenis plaatsvindt in een ander systeem.
2. Wanneer je real-time updates wilt ontvangen vanuit een ander systeem.
3. Wanneer je de constante polling van een ander systeem voor updates wilt vermijden.

Hier zijn drie voorbeelden uit real-time waarbij je Webhooks gebruikt: 

1. Je bent bezig met het bouwen van een klantenservice-chatbot. Je wilt direct op de hoogte worden gesteld zodra een bezoeker een bericht stuurt. Je kunt een Webhook gebruiken om direct op de hoogte te worden gesteld zodra het bericht is ontvangen.
2. Je bouwt een platform voor aandelenhandel. Je wilt real-time updates over de aandelenprijzen. Je kunt een Webhook gebruiken om direct op de hoogte te worden gesteld zodra de prijzen veranderen.
3. Je bent bezig met het bouwen van een projectmanagementtool. Je wilt een melding zodra een teamlid een taak voltooit. Je kunt een Webhook gebruiken om direct op de hoogte te worden gesteld zodra de taak als 'voltooid' wordt gemarkeerd.

Conclusie

Zoals je hebt kunnen zien in deze post, zijn zowel API's als Webhooks van onschatbare waarde als het gaat om het integreren en uitwisselen van gegevens tussen twee systemen. Terwijl API's draaien om het traditionele vraag-antwoordmodel, bieden Webhooks een efficiëntere benadering doordat het ontvangende systeem de gegevens proactief in realtime naar het aanvragende systeem kan sturen. Bovendien zijn API's breder in gebruik en eenvoudiger te implementeren dan Webhooks, die in bepaalde situaties een betere keuze zijn. Kortom, de keuze tussen API of Webhook hangt volledig af van de behoeften van je project.