Dieser Artikel erklärt, wie du mithilfe der Gelato-API Webhooks konfigurierst, um Benachrichtigungen in deiner Anwendung zu erhalten, sobald bei deiner Bestellung ein Ereignis auftritt.
Webhook-Konfiguration
Die Gelato-API bietet eine leistungsstarke Webhook-Funktionalität, mit der du über wichtige Ereignisse rund um deine Bestellungen auf dem Laufenden bleibst. So konfigurierst du deine Webhooks:
Greife auf das Gelato-Dashboard zu und navigiere zum Bereich Webhooks. Dieser dedizierte Bereich bietet eine zentrale Anlaufstelle für die Verwaltung deiner Webhook-Konfigurationen.
Klicke auf die Schaltfläche „Webhook hinzufügen“, um die Erstellung eines neuen Webhooks zu starten. Dadurch wird dir ein Konfigurationsformular angezeigt, in dem du die Details deines Webhooks festlegen kannst.
Gib die URL des Endpunkts in deiner Anwendung an, der die Webhook-Benachrichtigungen empfängt. Achte darauf, dass diese URL öffentlich zugänglich ist und korrekt konfiguriert wurde, um eingehende HTTP-Anfragen zu verarbeiten. Wähle die HTTP-Methode — entweder GET oder POST — die zu den Anforderungen deiner Anwendung passt. Entscheide dich für die spezifischen Ereignistypen, die du abonnieren möchtest. Gelato bietet eine umfassende Liste von Ereignistypen, zum Beispiel Auftragserstellung, Auftragsaktualisierungen und Versandbenachrichtigungen, sodass du die Benachrichtigungen sehr fein steuern kannst. Ausführliche Beschreibungen zu jedem Ereignistyp findest du in der API-Dokumentation.
Richte die Autorisierung für deinen Webhook ein, um die Sicherheit zu erhöhen und sicherzustellen, dass die Benachrichtigungen aus einer vertrauenswürdigen Quelle stammen. Wähle den passenden Autorisierungstyp, zum Beispiel HTTP-Header oder Query-Parameter. Gib die erforderlichen Zugangsdaten, wie einen API-Schlüssel oder ein Token, in die vorgesehenen Felder ein. Um deine Webhook-Konfiguration zu bestätigen und sicherzustellen, dass Benachrichtigungen erfolgreich zugestellt werden, sende eine Testbenachrichtigung an den angegebenen Endpunkt. Dieser Schritt hilft, mögliche Probleme zu erkennen und zu beheben, bevor der Webhook in einer Live-Umgebung bereitgestellt wird.
Webhooks verwalten
Sobald du deine Webhooks konfiguriert hast, kannst du sie ganz einfach über das Gelato Dashboard verwalten. Der Bereich „Webhooks“ bietet dir eine umfassende Übersicht über alle deine Webhooks und ermöglicht dir Aktionen wie:
Bearbeiten bestehender Webhooks: Passe die Konfiguration deiner Webhooks jederzeit an, um sie deinen sich entwickelnden Anforderungen anzupassen. Aktualisiere bei Bedarf die Benachrichtigungs-URL, die Ereignisabonnements oder die Autorisierungsdetails.
Webhooks löschen: Entferne Webhooks, die nicht mehr benötigt werden, um eine saubere und übersichtliche Webhook-Konfiguration zu behalten. Das Löschen eines Webhooks verhindert, dass Benachrichtigungen an den zugehörigen Endpunkt gesendet werden.
Für ein tieferes Verständnis der Gelato-API, einschließlich ausführlicher Informationen zu Webhook-Ereignissen und Payloads, schau dir bitte unsere umfassende technische Dokumentation an.
Um zum Bereich Webhooks in deinem Gelato-Konto zu gelangen, kannst du im linken Menü direkt zu Developer > Webooks gehen.