Was ist ein Webhook und warum ist er praktischer als Abfragen?

Mit einer API fragt Ihr System: Ist diese Nachricht schon angekommen? Mit einem Webhook wird es umgedreht — es wird Ihnen gemeldet, sobald sich etwas ändert.

Warum das besser ist

Ohne Webhook müssen Sie ständig nachfragen. Fragen Sie jede Minute, machen Sie Hunderte nutzlose Aufrufe für jeden, der etwas ergibt. Fragen Sie jede Stunde, erfahren Sie es zu spät.

Was Sie brauchen

Eine Adresse auf Ihrem eigenen Server, die eine Nachricht entgegennehmen kann und die immer erreichbar ist. Letzteres wird unterschätzt: Ist Ihr Server kurz aus, verpassen Sie die Meldung.

Zwei Dinge, die Sie sofort richtig machen

Antworten Sie schnell — verarbeiten Sie die Nachricht danach, nicht davor. Eine langsame Bestätigung führt zu wiederholten Versuchen.

Rechnen Sie mit Dubletten. Bei einem Netzproblem kann dieselbe Meldung zweimal eintreffen. Sorgen Sie dafür, dass Ihre Verarbeitung damit umgehen kann, zum Beispiel indem Sie sich die Nachrichten-ID merken.

Wofür Sie sie einsetzen

Zustellstatus und eingehende Antworten. Genau die zwei Dinge, von denen Sie erfahren wollen, sobald sie passieren.