Naar de inhoud
Begrippenlijst

Wat is een webhook?

Een webhook is een automatisch bericht dat een systeem naar een vooraf ingesteld webadres stuurt zodra er iets gebeurt, bijvoorbeeld 'uren goedgekeurd' of 'nieuwe medewerker aangemaakt'. Zo hoeft het ontvangende systeem niet steeds zelf te vragen of er iets nieuws is.

Hoe werkt een webhook?

Je geeft in het ene systeem een URL op van het andere systeem en kiest op welke gebeurtenissen je een bericht wilt krijgen. Gebeurt dat, dan stuurt het eerste systeem een HTTP-verzoek met de details, meestal als JSON. Het ontvangende systeem verwerkt het bericht en bevestigt de ontvangst.

Het verschil met een API: bij een API vraag jij om gegevens (pull), bij een webhook krijg je ze vanzelf (push). In de praktijk gebruik je ze vaak samen: de webhook meldt dat er iets is veranderd, en via de API haal je de volledige gegevens op.

Beveiliging

Omdat een webhook-URL openbaar bereikbaar is, moet de ontvanger kunnen controleren dat een bericht echt van de afzender komt. Daarvoor wordt elk bericht ondertekend met een geheime sleutel (HMAC). De ontvanger rekent de handtekening na en negeert berichten die niet kloppen. Een goede implementatie probeert het bovendien opnieuw als de ontvanger tijdelijk niet bereikbaar is.

TimeTracking stuurt webhooks met een HMAC-handtekening en probeert mislukte afleveringen opnieuw. Je kunt ze gebruiken om bijvoorbeeld goedgekeurde uren door te zetten naar je eigen backoffice of CRM. Daarnaast is er een REST API met OpenAPI-specificatie, beschikbaar vanaf Core.

Probeer TimeTracking gratis

Gratis tot 5 gebruikers. Core vanaf € 1 per gebruiker per maand, alles inbegrepen.