Ein echter Webhook-Dispatcher. Registrieren Sie ein Abonnement, lösen Sie ein Ereignis aus, und das Backend sendet einen HTTP-POST-Request an Ihre URL (z. B. https://webhook.site). Prüfen Sie Zustellungsversuche, analysieren Sie Fehler und verifizieren Sie die im X-FunAPI-Signature-Header gesendete HMAC-SHA256-Payload-Signatur.
Basis-URL: https://funapi.dev/api/webhooks/v1 · 8 Endpunkte · OpenAPI-3.1-Spezifikation und Postman-Collection verfügbar. Neu hier? Lesen Sie die Einstiegsanleitung.
Wer wird benachrichtigt und warum?
POST /webhooks/v1/subscriptions — Registrieren Sie ein Webhook-Abonnement (erfordert Bearer-Auth) · Antwortet mit 201 400 401 Link zu diesem EndpunktGET /webhooks/v1/subscriptions — Liste der Webhook-Abonnements (Geheimnisse geschwärzt) (erfordert Bearer-Auth) · Antwortet mit 200 Link zu diesem EndpunktDELETE /webhooks/v1/subscriptions/{id} — Abbestellen (erfordert Bearer-Auth) · Antwortet mit 204 401 403 404 Link zu diesem EndpunktVersuche, Wiederholungen und Unterschriftenprüfungen
POST /webhooks/v1/trigger — Ein Ereignis an alle übereinstimmenden Abonnements senden (echter HTTP-POST-Anruf) (erfordert Bearer-Auth) · Antwortet mit 200 201 400 Link zu diesem EndpunktGET /webhooks/v1/deliveries — Zustellversuche auflisten, nach Status oder Abonnement filtern (erfordert Bearer-Auth) · Antwortet mit 200 400 Link zu diesem EndpunktPOST /webhooks/v1/deliveries/{id}/replay — Wiederholen eines Zustellversuchs – sendet den eigentlichen HTTP POST-Request erneut (409 nach 3 Versuchen). (erfordert Bearer-Auth) · Antwortet mit 200 401 404 409 Link zu diesem EndpunktPOST /webhooks/v1/verify-signature — Überprüfung einer Nutzlastsignatur (echter HMAC-SHA256) · Antwortet mit 200 400 Link zu diesem EndpunktPOST /webhooks/v1/ordering — Doppelte und umgekehrte Umschläge erzeugen, ohne ausgehende Anfragen zu senden (erfordert Bearer-Auth) · Antwortet mit 200 400 401 404 409 422 Link zu diesem EndpunktDie Webhooks-API ist die Empfängerseite: Sie registriert eine Callback-URL, löst ein Ereignis aus und prüft anschließend die empfangenen Daten und gibt sie wieder. Die Daten werden mit einem HMAC signiert, sodass Sie das Überprüfen von Signaturen üben können – einschließlich des Vergleichs in konstanter Zeit und des Wiedergabefensters, die einen echten Verifizierer von einem einfachen Gleichheitsvergleich unterscheiden.
Zuletzt aktualisiert