Liens de rappel

Si vos paramètres réseau restreignent l’accès aux connexions entrantes, vous devez autoriser le trafic entrant provenant d’adresses IP afin de recevoir des événements de lien de rappel de Samsara.

Vous pouvez consulter la liste des adresses IP statiques dans le tableau de bord Samsara (Paramètres > Liens de rappel).

Apprenez-en davantage sur la gestion de l’accès réseau pour les liens de rappel sur notre site des développeurs.

Samsara s’attend à ce que le point de terminaison de votre lien de rappel renvoie un code d’état HTTP 2xx pour confirmer la réception de chaque notification. Tout état 2xx, y compris 202 Accepted, constitue une livraison réussie. Samsara ne tente pas de nouveau une livraison réussie.

Si votre point de terminaison ne répond pas dans les 10 secondes ou renvoie un état HTTP de 400 ou plus, Samsara traite la tentative comme une erreur de livraison. Samsara tente de nouveau d’envoyer la même notification avec un délai d’attente exponentiel, jusqu’à cinq tentatives. Après cinq tentatives échouées, Samsara ne tente plus d’envoyer cette notification.

Si votre point de terminaison renvoie une redirection (HTTP 3xx), Samsara traite la tentative comme une erreur de livraison et ne tente pas de nouveau d’envoyer la notification.

Vous pouvez consulter l’activité des liens de rappel dans Métriques des développeurs.

Dans l’onglet Trafic des liens de rappel, vous pouvez examiner les tentatives de livraison des 7 derniers jours, y compris les codes d’état HTTP. Vous pouvez filtrer par code d’état, nom du lien de rappel et source des données utiles. La fréquence de réussite correspond au pourcentage de réponses 2xx.

Si une livraison expire, la tentative est enregistrée avec le code d’état 499.

Vous pouvez désactiver ou réactiver un lien de rappel dans Paramètres > Liens de rappel.

Lorsqu’un lien de rappel est désactivé, Samsara n’envoie pas de nouveaux événements à ce lien de rappel. Après avoir réactivé le lien de rappel, Samsara reprend la livraison des nouveaux événements. Les événements qui se sont produits pendant que le lien de rappel était désactivé ne sont pas envoyés.