Een webhook is een mechanisme waarmee Samsara een HTTP-verzoek naar uw applicatie kan sturen wanneer er een gebeurtenis plaatsvindt. Webhooks bestaan in de Samsara connected operations cloud als onderdeel van twee functies:
-
Waarschuw webhooks: Voorbeelden hiervan zijn geofence-waarschuwingen en snelheidswaarschuwingen
-
Abonnementen op evenementen: Voorbeelden hiervan zijn het ingediende document en het bijgewerkte voertuig
Bekijk de Webhaken pagina op de ontwikkelaarssite van Samsara voor meer informatie over het configureren van beveiligde webhooks in uw dashboard of het gebruik van onze API.
Als uw netwerkinstellingen de toegang voor inkomende verbindingen beperken, moet u inkomend verkeer van IP-adressen toestaan om Webhook-gebeurtenissen van Samsara te ontvangen.
U kunt de lijst met statische IP-adressen bekijken in het Samsara-dashboard (Instellingen > Webhooks).
Lees meer over het beheren van netwerktoegang voor webhooks op onze ontwikkelaarssite.
Samsara verwacht dat uw webhookeindpunt een HTTP-2xx-statuscode retourneert om de ontvangst van elke melding te bevestigen. Elke 2xx-status, inclusief 202 Accepted, geldt als een succesvolle bezorging. Samsara probeert een succesvolle bezorging niet opnieuw.
Als uw eindpunt niet binnen 10 seconden reageert of een HTTP-status van 400 of hoger retourneert, beschouwt Samsara de poging als een bezorgingsfout. Samsara probeert dezelfde melding opnieuw met exponentiële back-off, tot maximaal vijf pogingen. Na vijf mislukte pogingen probeert Samsara die melding niet opnieuw.
Als uw eindpunt een omleiding retourneert (HTTP 3xx), beschouwt Samsara de poging als een bezorgingsfout en probeert de melding niet opnieuw.
Tip
Retourneer zo snel mogelijk een 2xx-respons. Voer verwerking die langer duurt asynchroon op de achtergrond uit.
U kunt webhookactiviteit bekijken in Ontwikkelaarsgegevens.
Op het tabblad Webhookverkeer kunt u bezorgpogingen van de afgelopen 7 dagen bekijken, inclusief HTTP-statuscodes. U kunt filteren op statuscode, webhooknaam en payloadbron. Het succespercentage is het percentage 2xx-responsen.
Als een bezorging een time-out krijgt, wordt de poging geregistreerd met statuscode 499.
U kunt een webhook uitschakelen of opnieuw inschakelen via Instellingen > Webhooks.
Zolang een webhook is uitgeschakeld, stuurt Samsara geen nieuwe gebeurtenissen naar die webhook. Nadat u de webhook opnieuw hebt ingeschakeld, hervat Samsara de bezorging van nieuwe gebeurtenissen. Gebeurtenissen die plaatsvonden terwijl de webhook was uitgeschakeld, worden niet verzonden.
Opmerkingen
0 opmerkingen
U moet u aanmelden om een opmerking te plaatsen.