Zum Hauptinhalt springen
SVDY Logo
Entwickler-Anleitung
Verfügbar
Professional Tarif

Erfahren Sie es, sobald etwas passiert

Ihr Backend erhält innerhalb von Sekunden ein POST nach einem Stempelvorgang oder einer genehmigten Abwesenheit — kein Polling, keine Cron-Jobs. Signierte Zustellungen, automatische Wiederholungen, Dead-Letter-Queue, falls Ihr Endpoint ausfällt.

Was Sie damit machen können

Die ersten Erfolge am Tag eins. Ein KMU-Admin richtet das ohne Engineering ein.

Echtzeit, kein Polling

Stempelvorgänge, Urlaubs-Genehmigungen, Status-Änderungen — Ihr Endpoint bekommt in Sekunden einen POST. Kein API-Polling alle 5 Minuten (günstiger und schneller).

Manipulationssichere Zustellungen

Jede Anfrage enthält X-SVDY-Signature: sha256=… berechnet über den JSON-Body mit Ihrem Secret. Verifizieren Sie die Signatur im Endpoint, um manipulierte Requests kalt abzuweisen.

Retries + Dead-Letter-Queue

Nicht-2xx-Antworten werden bei 1m, 5m, 30m, 2h, 12h wiederholt. Nach 5 Fehlern landet die Zustellung in der Dead-Letter-Queue, sichtbar in /system/integrations/webhooks. Sie verlieren keine Events, wenn Ihr Endpoint mal einen schlechten Tag hat.

In 4 Schritten einrichten

Geschätzte Dauer: unter 5 Minuten für einen Admin mit den nötigen Zugangsdaten zur Hand.

1

Webhook im Org-Admin erstellen

Integrationen → Webhooks → Webhook hinzufügen. Endpoint-URL eintragen + Events auswählen. SVDY zeigt den Signing-Secret EINMAL — jetzt sichern.

2

Den Receiver bauen

Ihr Endpoint akzeptiert POST application/json. HMAC-Signatur vor der Verarbeitung verifizieren. 200 in unter 10 Sekunden zurückgeben (sonst nimmt SVDY Fehler an und wiederholt).

# Python receiver — Flask sketch
import hmac, hashlib, json
from flask import request, abort

SVDY_SECRET = b"<paste-from-svdy-admin>"

@app.post("/webhooks/svdy")
def receive():
    sig = request.headers.get("X-SVDY-Signature", "")
    expected = "sha256=" + hmac.new(
        SVDY_SECRET, request.data, hashlib.sha256
    ).hexdigest()
    if not hmac.compare_digest(sig, expected):
        abort(401)
    event = json.loads(request.data)
    # ... handle event["type"], event["data"]
    return "", 200
3

Mit „Test-Event senden" testen

Im Webhook-Detail-Panel — feuert ein synthetisches Event an Ihren Endpoint. Antwortcode + Body erscheinen sofort im Delivery-Log.

4

Fehlgeschlagene Zustellungen wiederholen

Jede Zustellung erscheint im Activity-Panel mit Status (zugestellt / wiederholt / tot). „Replay" auf einer toten Zustellung klicken, um sie nach Endpoint-Reparatur erneut auszulösen.


Bereit zum Verbinden?

Öffnen Sie die Admin-Konsole Ihrer Organisation → Integrationen und verbinden Sie diese Integration in unter 5 Minuten.