Übersicht
Webhooks ermöglichen es, externe Systeme in Echtzeit über Ereignisse in Stampfactory zu informieren. Bei bestimmten Aktionen (z.B. Stempelung, Abwesenheitsantrag) wird automatisch eine HTTP-Anfrage an eine von Ihnen definierte URL gesendet.
Webhook erstellen
Neuen Webhook anlegen
Navigieren Sie zu Einstellungen > Webhooks und klicken Sie auf Neuer Webhook.
URL eingeben
Geben Sie die Ziel-URL ein, an die Ereignisse gesendet werden sollen.
Ereignisse wählen
Wählen Sie die Ereignisse, bei denen der Webhook ausgelöst werden soll.
Speichern
Der Webhook wird sofort aktiviert.
Sicherheit
Alle Webhook-Anfragen werden mit HMAC-SHA256 signiert. Der Signaturwert wird im Header X-Stamp-Signature mitgesendet. Zusätzlich enthält jede Anfrage eine eindeutige Request-ID im Header X-Stamp-Request-Id.
Signatur verifizieren
Verifizieren Sie immer die Signatur, um sicherzustellen, dass die Anfrage tatsächlich von Stampfactory stammt.
Zustellungsprotokoll
Jede Webhook-Zustellung wird protokolliert:
Wiederholung
Fehlgeschlagene Zustellungen (HTTP-Status >= 400 oder Timeout) werden automatisch wiederholt. Nach mehreren Fehlversuchen wird der Webhook deaktiviert und Sie erhalten eine Benachrichtigung.
Webhook deaktivieren / löschen
Webhooks können jederzeit deaktiviert oder gelöscht werden. Das Zustellungsprotokoll bleibt auch nach dem Löschen erhalten.
