Ein Webhook ist eine Nachricht, die das System des Anbieters an eine von dir genannte Adresse schickt, sobald ein bestimmtes Ereignis eintritt. Ohne Webhook muss deine Software die API des Anbieters immer wieder fragen, ob sich etwas geändert hat, was unnötig viele Anfragen kostet und den Kunden länger warten lässt. Aniva sendet für jede Statusänderung einer Probe einen signierten Webhook, sodass dein System pro Änderung genau einmal informiert wird.
Die Signierung ist wichtig, da deine veröffentlichte Adresse von jedem erreicht werden kann, der sie findet. Eine Signatur ermöglicht es deinem Code zu prüfen, ob eine Nachricht wirklich vom Anbieter stammt, bevor dein Produkt darauf reagiert. Wiederholungen sind aus demselben Grund wichtig, denn dein Endpunkt wird hin und wieder nicht erreichbar sein und die Nachricht muss erneut gesendet werden.
- Frage nach, welche Ereignisse einen Webhook auslösen und was die einzelnen Nachrichten enthalten.
- Frage, wie Nachrichten signiert werden und wo die Schritte zur Überprüfung dokumentiert sind.
- Frage, was passiert, wenn dein Endpunkt offline ist, und wie oft ein erneuter Versuch gestartet wird.
- Frage, ob vergangene Ereignisse nach einem Ausfall auf deiner Seite noch einmal gesendet werden können.
Ein Webhook macht die API nicht überflüssig, da dein System nach Erhalt der Nachricht immer noch das vollständige Ergebnis abruft. Teams, die auf Webhooks verzichten, fragen die API stattdessen in festen Abständen ab, was für Kunden, die auf ihren Bericht warten, langsamer ist.
In diesem Glossar behandelt REST API die Schnittstelle, die dein Code aufruft, während Time-to-Result die Wartezeit beschreibt, die dein Kunde spürt, und Partner-Portal den Weg für Teams ohne Entwickler aufzeigt.
Dieser Glosserieneintrag dient der allgemeinen Information und ist keine medizinische Beratung. Er ist nicht dazu gedacht, Krankheiten zu diagnostizieren, zu behandeln oder auszuschließen. Besprich deine Ergebnisse am besten mit einem Arzt, der deine Geschichte kennt.
