Webhooks testen, bevor dein Endpoint existiert
Von SyncBuilder
Ein webhook ist eine umgekehrte API. Statt dass du einen Dienst abfragst, ob sich etwas geändert hat, ruft der Dienst deine URL mit einer HTTP request auf, sobald ein Ereignis eintritt, etwa wenn eine Bestellung aufgegeben wird oder eine Zahlung erfolgreich ist.
Das Problem: Du siehst nicht, was du nicht empfangen kannst
Um einen webhook zu bauen oder zu debuggen, musst du die genaue request sehen, die ein Anbieter sendet, samt Method, Headers und Body. Das ist schwierig, bevor dein eigener endpoint überhaupt existiert, denn es gibt keinen Ort, an den der Anbieter die request zustellen kann, und nichts, um sie aufzuzeichnen.
Die Lösung: eine Capture-URL
Eine Capture-URL, manchmal request bin genannt, löst das. Du lässt den Anbieter auf eine temporäre URL zeigen und untersuchst dann jede eingehende request. Sobald du die Form des Datenverkehrs kennst, baust du deinen echten endpoint mit Sicherheit. Achte auf:
- Die HTTP method, die der Anbieter verwendet, meist POST, aber nicht immer
- Die Headers, besonders content-type und etwaige signature-Headers
- Den rohen Body oder payload, genau so, wie er ankommt
- Die query string, die an die URL angehängt ist
- Wie oft Retries eintreffen, wenn eine Zustellung nicht bestätigt wird
Überprüfe in der Produktion immer die signature des Anbieters und nutze HTTPS. Lass einen öffentlichen Test-endpoint niemals auf echte Systeme zeigen.
Unser kostenloser Webhook Tester gibt dir eine Wegwerf-Capture-URL und zeigt jede eingehende request live an, damit du genau siehst, was ein System sendet.
Kostenloses Tool ausprobieren