Ein Webhook ist ein Mechanismus, der es Samsara ermöglicht, beim Eintreten eines Ereignisses eine HTTP-Anfrage an Ihre Anwendung zu senden. Webhooks sind in der Samsara Connected Operations Cloud als Teil von zwei Funktionen vorhanden:
-
Webhooks warnen: Beispiele hierfür sind Geofence-Warnungen und Geschwindigkeitswarnungen
-
Veranstaltungsabonnements: Beispiele hierfür sind eingereichte Dokumente und Fahrzeugaktualisierungen
Schau den Webhooks Weitere Informationen zum Konfigurieren sicherer Webhooks in Ihrem Dashboard oder mithilfe unserer API finden Sie auf der Samsara-Entwicklersite.
Wenn Ihre Netzwerkeinstellungen den Zugriff für eingehende Verbindungen einschränken, müssen Sie eingehenden Datenverkehr von IP-Adressen zulassen, um Webhook-Ereignisse von Samsara zu empfangen.
Sie können die Liste der statischen IP-Adressen im Samsara-Dashboard anzeigen (Einstellungen > Webhooks).
Weitere Informationen zur Verwaltung des Netzwerkzugriffs für Webhooks finden Sie auf unserer Entwicklerseite.
Samsara erwartet, dass Ihr Webhook-Endpunkt einen HTTP-Statuscode 2xx zurückgibt, um den Empfang jeder Benachrichtigung zu bestätigen. Jeder 2xx-Status, einschließlich 202 Accepted, gilt als erfolgreiche Zustellung. Samsara wiederholt eine erfolgreiche Zustellung nicht.
Wenn Ihr Endpunkt nicht innerhalb von 10 Sekunden antwortet oder einen HTTP-Status von 400 oder höher zurückgibt, behandelt Samsara den Versuch als Zustellfehler. Samsara wiederholt dieselbe Benachrichtigung mit exponentiellem Backoff bis zu fünfmal. Nach fünf fehlgeschlagenen Versuchen wiederholt Samsara diese Benachrichtigung nicht.
Wenn Ihr Endpunkt eine Weiterleitung (HTTP 3xx) zurückgibt, behandelt Samsara den Versuch als Zustellfehler und wiederholt die Benachrichtigung nicht.
Tipp
Geben Sie so schnell wie möglich eine 2xx-Antwort zurück. Führen Sie länger andauernde Verarbeitung asynchron im Hintergrund durch.
Sie können die Webhook-Aktivität in Entwickler-Metriken anzeigen.
Auf der Registerkarte Webhook-Datenverkehr können Sie Zustellversuche der vergangenen 7 Tage einschließlich HTTP-Statuscodes überprüfen. Sie können nach Statuscode, Webhook-Name und Nutzdatenquelle filtern. Die Erfolgsrate ist der Prozentsatz der 2xx-Antworten.
Wenn bei einer Zustellung eine Zeitüberschreitung auftritt, wird der Versuch mit dem Statuscode 499 aufgezeichnet.
Sie können einen Webhook unter Einstellungen > Webhooks deaktivieren oder wieder aktivieren.
Während ein Webhook deaktiviert ist, sendet Samsara keine neuen Ereignisse an diesen Webhook. Nachdem Sie den Webhook wieder aktiviert haben, setzt Samsara die Zustellung neuer Ereignisse fort. Ereignisse, die aufgetreten sind, während der Webhook deaktiviert war, werden nicht gesendet.
Kommentare
0 Kommentare
Bitte melden Sie sich an, um einen Kommentar zu hinterlassen.