Webhooks testen voordat je endpoint bestaat

Een webhook is een omgekeerde API. In plaats van dat jij een service pollt om te vragen of er iets is veranderd, roept de service jouw URL aan met een HTTP request op het moment dat er een gebeurtenis plaatsvindt, bijvoorbeeld wanneer een bestelling wordt geplaatst of een betaling slaagt.

Het probleem: je ziet niet wat je niet kunt ontvangen

Om een webhook te bouwen of te debuggen moet je de exacte request zien die een provider verstuurt, inclusief de method, headers en body. Dat is lastig voordat je eigen endpoint bestaat, want er is nog geen plek waar de provider de request kan afleveren en niets om die vast te leggen.

De oplossing: een capture-URL

Een capture-URL, soms een request bin genoemd, lost dit op. Je laat de provider naar een tijdelijke URL wijzen en inspecteert vervolgens elke request die binnenkomt. Zodra je de vorm van het verkeer kent, bouw je met vertrouwen je echte endpoint. Let op:

• De HTTP method die de provider gebruikt, meestal POST maar niet altijd
• De headers, vooral content-type en eventuele signature-headers
• De ruwe body of payload, precies zoals die binnenkomt
• De query string die aan de URL is toegevoegd
• Hoe vaak retries binnenkomen als een aflevering niet wordt bevestigd

Onze gratis Webhook Tester geeft je een wegwerp-capture-URL en toont elke binnenkomende request live, zodat je precies ziet wat een systeem verstuurt.