Webhooks

Kurz: Ein Webhook ist eine Benachrichtigung, bei der ein Dienst eine Adresse deiner Anwendung aufruft, sobald etwas passiert, zum Beispiel eine Zahlung abgeschlossen wurde.

Genauer: Statt dass deine Anwendung ständig nachfragt („Polling”), meldet sich der andere Dienst von selbst. Er schickt eine HTTP-POST-Anfrage mit den Daten des Ereignisses an eine URL, die du angegeben hast.

Im Detail

• Signatur prüfen: Jeder kann die URL aufrufen. Der Absender signiert die Nachricht (HMAC), und du prüfst die Signatur mit einem geheimen Schlüssel.
• Schnell antworten: Mit 2xx bestätigen, die Arbeit danach im Hintergrund machen.
• Wiederholungen: Bleibt die Bestätigung aus, sendet der Absender erneut. Darum Idempotenz.
• Reihenfolge: Ereignisse können vertauscht ankommen.
• Lokale Tests: Tunnel-Dienste leiten Webhooks auf den Entwicklungsrechner.

Siehe auch: Idempotenz, Message Queue (Nachrichtenwarteschlange)