Hoe je Webhook.site gebruikt om je API-verzoeken te troubleshooten

Webhook.site is een gratis tool van een derde partij waarmee je ruwe HTTP-verzoeken kunt bekijken en vastleggen die vanuit integraties, workflows of custom API-calls worden verstuurd. Met Webhook.site kun je eenvoudig webhook-payloads debuggen, configuratie verifiëren en problemen troubleshooten voordat je payloads naar Voluit Suite of je productie-endpoints stuurt.

Wat is Webhook.site

Webhook.site genereert direct een unieke test URL die alle binnenkomende webhook-verzoeken verzamelt en in real-time weergeeft. Dit maakt het ideaal voor:

• Het vastleggen van ruwe webhook-payloads (headers, body, method)
• Het valideren van de structuur van verzoeken voordat je ze naar je live endpoint stuurt
• Het troubleshooten van integraties vanuit Zapier, Make (Integromat), custom apps of andere automatiseringstools

BELANGRIJK: De stappen in dit artikel zijn bedoeld voor Geavanceerde Integratie en uitsluitend ter informatie. We bieden momenteel geen ondersteuning of service voor de Basis of Geavanceerde API vanwege de complexiteit ervan.

Hoe het werkt

Stap 1: Ga naar Webhook.site

Open https://webhook.site in je browser. Er wordt automatisch een unieke test URL gegenereerd.

Stap 2: Klik op "Copy to clipboard" naast je unieke Test Webhook op de homepage

Stap 3: Ga naar je Custom Integratie, zoals Zapier of een andere third-party oplossing

Voor dit voorbeeld gebruiken we Zapier. Om Webhook.site te gebruiken voor testen, klik je op "Set Up Action."

Stap 4: Vervang de Voluit Suite API URL door de Webhook.site test URL

Wissel tijdelijk de Voluit Suite API URL in voor de Webhook.site URL voor testdoeleinden. Je volgt een vergelijkbaar proces voor elke andere custom integratie die data naar Voluit Suite POST.

Stap 5: Sla je wijzigingen op

Sla je wijzigingen op en voer vervolgens de flow uit die normaal gesproken de webhook zou activeren. Als je tool of integratie (zoals Zapier, Integromat, etc.) een ingebouwde testtool heeft, gebruik deze dan niet. Gebruik in plaats daarvan een real-world voorbeeld. Als de webhook wordt geactiveerd wanneer een formulier wordt ingevuld, ga dan naar het formulier en vul een test in. Als de automatisering wordt geactiveerd wanneer een actie wordt uitgevoerd in een extern systeem, voer dan die actie uit.

Dit geeft jou en je ontwikkelaars de meest nauwkeurige informatie en is zeer waardevol bij het troubleshooten van geavanceerde API-gerelateerde problemen.

Stap 6: Bekijk de Payload Data

Vervolgens krijg je de ruwe data te zien die Voluit Suite ontvangt telkens wanneer de webhook wordt uitgevoerd. Je kunt dit vergelijken met de informatie die beschikbaar is op onze API-documentatiewebsites om je configuratie te testen.

Stap 7: Klik op Copy

Klik op Copy rechtsboven in het Raw Data invoerveld om de volledige Payload te kopiëren. Bewaar dit voor troubleshooting met je ontwikkelaars of met het Voluit Suite team.