Skip to main content
AccueilBlogGuidesLa demande de suivi en temps réel a expiré ? Règles de nouvelle tentative, de solution de repli et de statut à suivre

La demande de suivi en temps réel a expiré ? Règles de nouvelle tentative, de solution de repli et de statut à suivre

17TRACK

Lorsqu’une demande de suivi en temps réel expire, considérez le dernier statut de l’envoi comme inconnu — et non comme retardé, perdu ou inchangé. Réessayez uniquement dans une limite de temps définie, puis affichez une mise à jour clairement signalée comme étant la dernière connue ou demandez à l’utilisateur de réessayer plus tard. Pendant tout le processus, gardez séparés le résultat de la demande, la fraîcheur des données et le statut réel du colis.

La demande de suivi en temps réel a expiré : nouvelle tentative, solution de repli et statut

Cette distinction est importante tant pour les pages de suivi destinées aux clients que pour les systèmes qui utilisent les données de suivi afin de déclencher des notifications ou des workflows d’assistance. Une expiration indique qu’une réponse n’est pas arrivée à temps. Elle ne vous indique pas si le transporteur dispose d’un nouvel événement, si un service en amont a traité la demande ou si le colis a bougé.

Commencez par identifier ce qui a expiré

Une demande de suivi peut échouer à plusieurs étapes : le navigateur peut cesser d’attendre votre application, votre application peut cesser d’attendre une API de suivi ou cette API peut expirer en contactant un autre service. L’utilisateur peut voir la même erreur générique dans chaque cas, mais l’action appropriée diffère.

  • Expiration côté client : L’application a cessé d’attendre. La demande côté serveur peut néanmoins avoir été traitée. Consultez vos propres journaux de demandes ou votre magasin de résultats avant d’émettre une autre demande susceptible de dupliquer le travail.
  • Échec du réseau ou de la connexion : Votre système n’a pas reçu de réponse exploitable. Vous ne savez peut-être pas si le service distant a traité la demande.
  • HTTP 504 : Une passerelle ou un proxy n’a pas reçu de réponse à temps d’un serveur en amont. Cela décrit le chemin de la demande, pas l’envoi.
  • HTTP 408 : Le serveur n’a pas reçu un message de demande complet dans le délai pendant lequel il était prêt à attendre. Il ne s’agit pas d’un statut de suivi du transporteur.
  • HTTP 200 avec un ancien événement : La demande a abouti, mais les informations de suivi renvoyées peuvent encore être obsolètes. Une réponse HTTP réussie ne garantit pas la fraîcheur des données.

Enregistrez ces résultats comme des diagnostics de demande. Ne les traduisez pas en libellés d’envoi tels que « en transit », « exception » ou « livré ». Ces libellés doivent provenir d’événements de suivi ou d’un champ de statut documenté, et non de la couche de transport.

Utilisez une nouvelle tentative limitée, pas une boucle sans fin

Pour une consultation de suivi en lecture seule, il est souvent raisonnable de réessayer après une expiration. Cela doit néanmoins rester limité. Des demandes répétées peuvent augmenter la charge d’un service en difficulté, prolonger l’attente de l’utilisateur et créer un travail en double lorsque plusieurs couches de l’application réessaient indépendamment.

  1. Définissez une échéance totale. Décidez combien de temps l’opération destinée à l’utilisateur peut durer, en incluant la tentative initiale et toute nouvelle tentative. N’accordez pas à chaque tentative une nouvelle échéance complète qui dépasserait le temps d’attente acceptable pour l’appelant.
  2. Vérifiez si l’opération peut être répétée sans risque. Une consultation diffère normalement d’une demande qui enregistre un envoi, modifie des paramètres ou crée une ressource. Ne rejouez pas automatiquement une demande modifiant l’état, sauf si le contrat du fournisseur ou vos contrôles d’idempotence la rendent sûre.
  3. Réessayez parcimonieusement en cas d’échec temporaire. Utilisez un petit budget explicite de nouvelles tentatives et un délai avec jitter, plutôt que d’envoyer simultanément des tentatives immédiates depuis de nombreux clients.
  4. Respectez les instructions applicables du serveur. Si une réponse contient un en-tête Retry-After valide, ne planifiez pas de nouvelle tentative plus tôt. Respectez également toute limite plus stricte définie par l’application ou le fournisseur.
  5. Arrêtez-vous lorsque l’échéance ou le budget est épuisé. Passez à une réponse de repli et planifiez séparément une réconciliation ultérieure si votre workflow l’exige.

Une conception pratique peut autoriser une nouvelle tentative destinée à l’utilisateur s’il reste suffisamment de temps, tout en déplaçant les tentatives supplémentaires vers une actualisation en arrière-plan. Il s’agit d’un exemple de politique, et non d’une règle API universelle. Choisissez les limites en fonction de vos objectifs de niveau de service, de la latence observée et de la documentation du fournisseur. Comptez également les nouvelles tentatives effectuées par les bibliothèques HTTP, les passerelles et les workers ; sinon, une politique applicative apparemment modeste peut produire de nombreux appels en amont.

Pour HTTP 429, considérez la réponse comme un signal de limitation de débit plutôt que comme une raison de réessayer immédiatement. HTTP 503 peut indiquer une incapacité temporaire à traiter la demande, et un serveur peut fournir Retry-After. Un 504 peut être temporaire, mais il ne garantit pas que la tentative suivante fonctionnera. Les erreurs d’authentification nécessitent généralement de vérifier les identifiants ou les autorisations, tandis que les demandes mal formées nécessitent de corriger les entrées. Un identifiant de suivi qui produit un résultat « introuvable » exige davantage de prudence : selon le comportement documenté du fournisseur et l’étape de l’envoi, il peut être trop tôt pour trouver un enregistrement ou l’identifiant peut être incorrect. Ne transformez pas un tel résultat en affirmation définitive que le colis n’existe pas.

Choisissez une solution de repli qui préserve ce que vous savez

La solution de repli la plus sûre est généralement le dernier résultat de suivi vérifié, accompagné de l’heure de son propre événement et d’un libellé honnête indiquant sa fraîcheur. Gardez ce résultat distinct de l’échec de la demande actuelle. Une page peut indiquer : « Dernière mise à jour disponible : Départ du centre. Dernière vérification : [heure]. Une mise à jour plus récente est temporairement indisponible. » N’incluez « Dernière vérification » que si votre système l’enregistre réellement ; cette information ne remplace pas l’heure de l’événement du transporteur.

Utilisez l’heure la plus précise que vous pouvez justifier. L’heure d’un événement du transporteur indique quand l’événement aurait eu lieu. L’heure à laquelle votre système a reçu cet événement indique l’ingestion. L’heure à laquelle un utilisateur a ouvert la page ne décrit ni l’un ni l’autre. Si la source ne fournit pas d’heure d’événement ou de fuseau horaire fiable, n’en inventez pas. De même, si le résultat mis en cache ne comporte aucune heure de récupération enregistrée, appelez-le « dernière mise à jour disponible » plutôt que de prétendre qu’il a été actualisé récemment.

Une solution de repli doit respecter trois limites :

  • Présentez les données mises en cache comme des données mises en cache. Ne présentez pas un ancien événement comme le résultat de la demande ayant expiré.
  • Ne déduisez pas une progression du temps écoulé. Un colis n’est pas « en cours de livraison » simplement parce qu’il est en transit depuis plusieurs jours.
  • Ne dissimulez pas l’incertitude importante. S’il n’existe aucun résultat antérieur, indiquez que le suivi est temporairement indisponible au lieu d’afficher un statut par défaut inventé.

D’autres solutions de repli peuvent inclure un stockage de suivi synchronisé précédemment, une consultation autorisée auprès du transporteur ou une actualisation ultérieure en arrière-plan. Utilisez-les uniquement si elles correspondent à l’envoi, à vos autorisations et aux conditions de la source de données. Une deuxième source peut utiliser des noms d’événements différents ou présenter des retards de déclaration ; préservez donc la provenance et évitez de fusionner des enregistrements contradictoires sans règle définie. Si un client peut agir sur le résultat, proposez-lui un moyen de réessayer ou de contacter l’assistance plutôt que de laisser indéfiniment une animation de chargement.

Gardez séparés le statut de la demande, la fraîcheur des données et le statut de l’envoi

Il s’agit de trois champs différents, même si une interface utilisateur les affiche ensemble. Le statut de la demande indique si la consultation a réussi, a expiré ou a généré une erreur. La fraîcheur des données indique quand les informations renvoyées ou stockées ont été observées. Le statut de l’envoi indique ce que la source de suivi rapporte au sujet du colis. Les séparer empêche une défaillance temporaire de l’API d’écraser un événement de livraison valide ou de transformer un événement obsolète « en transit » en affirmation actuelle.

Par exemple, un système peut conserver un événement « Livré » vérifié lors d’une consultation précédente alors que l’actualisation actuelle expire. L’événement de livraison ne disparaît pas. L’état combiné correct est que le dernier statut d’envoi disponible est « livré » et que la dernière actualisation a échoué. À l’inverse, si le dernier événement est « En transit », une expiration ne confirme pas que le colis est encore en transit à cet instant ; elle confirme seulement qu’aucune réponse plus récente n’a été obtenue.

Appliquez une règle définie lorsque les événements arrivent dans le désordre. Comparez les identifiants d’événement, les horodatages, la source et, lorsqu’elles sont disponibles, les sémantiques de statut documentées par le fournisseur. Ne supposez pas que l’ordre dans lequel votre système a reçu les mises à jour est celui dans lequel les événements d’expédition se sont produits. De même, un événement plus ancien arrivé tardivement ne doit pas automatiquement remplacer un statut vérifié plus récent. Des corrections et des exceptions peuvent toutefois être légitimes ; évitez donc une règle générale considérant comme impossibles les changements de statut après la livraison. Conservez les événements sous-jacents et examinez les contradictions au lieu de réécrire silencieusement l’historique.

Si un fournisseur renvoie HTTP 202, interprétez-le conformément au contrat de ce point d’accès : l’acceptation d’une demande ne signifie pas, à elle seule, que la consultation de suivi est terminée. De même, HTTP 200 établit qu’une demande HTTP a réussi selon la sémantique de ce point d’accès ; cela ne prouve pas que chaque champ de suivi est présent ou à jour. Ne mappez les champs de réponse propres au fournisseur qu’après avoir vérifié sa documentation.

Rendez l’échec visible pour les opérateurs sans inquiéter les clients

Un enregistrement opérationnel utile comprend l’identifiant de la demande, le point d’accès ou l’opération, le nombre de tentatives, le temps écoulé, la couche ayant expiré, le statut HTTP s’il a été reçu et l’indication que la réponse provient d’une consultation en direct ou d’une solution de repli. Pour les données de suivi, enregistrez la source ainsi que les horodatages pertinents de l’événement ou de la récupération. Traitez les numéros de suivi et les informations client conformément aux règles d’accès et de conservation de votre organisation ; l’utilité des diagnostics ne justifie pas d’exposer des identifiants complets dans des journaux sans restriction.

Recherchez des tendances plutôt que de vous fier à une seule expiration. Un taux d’expiration en hausse sur un itinéraire de transporteur, des réponses 429 répétées ou un écart croissant entre l’heure de l’événement du transporteur et l’heure de récupération peuvent indiquer des problèmes différents. Le premier peut nécessiter une investigation auprès du fournisseur, le deuxième un contrôle du débit et le troisième une vérification de la synchronisation ou de la distribution des événements. Si une application propose le suivi par l’intermédiaire d’un fournisseur tel que l’API de suivi 17TRACK, utilisez la documentation de ce fournisseur pour vérifier les champs de réponse propres aux points d’accès, les limites de demande et la gestion des erreurs avant d’appliquer ces règles générales.

Pour le message destiné au client, soyez précis et mesuré : « Nous ne pouvons pas actualiser le suivi pour le moment. Voici la dernière mise à jour disponible. » Indiquez une prochaine étape lorsque cela est utile, par exemple réessayer plus tard ou contacter l’assistance si l’envoi dépasse le délai de livraison prévu communiqué par le vendeur ou le transporteur. Évitez de promettre un délai d’actualisation que votre système ne peut pas garantir.

Liste de contrôle de mise en production pour un flux de suivi résistant aux expirations

  • Confirmez quelle couche impose chaque délai d’expiration et quelle couche gère les nouvelles tentatives.
  • Définissez une échéance totale de demande et un budget séparé et limité pour les nouvelles tentatives.
  • Vérifiez que les opérations réessayées automatiquement peuvent être répétées sans risque.
  • Respectez les limites de débit et les instructions Retry-After valides.
  • Stockez séparément le résultat de la demande, le statut de l’envoi et l’historique des événements.
  • Étiquetez les données de repli et conservez leur source ainsi que leurs horodatages lorsqu’ils sont disponibles.
  • Testez les scénarios sans cache, avec cache obsolète, 429, 503, 504 et réponse tardive.
  • Vérifiez qu’une expiration ne peut pas déclencher une notification de livraison incorrecte ni effacer un événement vérifié.

La règle directrice est simple : ne réessayez une demande que si cela est sûr et utile ; ne faites appel à une solution de repli qu’avec des informations que vous pouvez identifier ; et ne déduisez jamais un statut d’envoi d’une expiration HTTP.

FAQ

Dois-je réessayer immédiatement une demande de suivi ayant expiré ?

Pas automatiquement. Vérifiez que l’opération peut être répétée sans risque, que l’échéance globale laisse du temps pour une autre tentative et qu’aucune instruction de limitation de débit n’impose d’attendre. Une nouvelle tentative courte et limitée avec jitter peut convenir à une consultation en lecture seule ; les tentatives immédiates répétées constituent un mauvais comportement par défaut.

HTTP 504 signifie-t-il que le système de suivi du transporteur est indisponible ?

Non. Cela signifie qu’une passerelle ou un proxy n’a pas reçu à temps une réponse en amont. Le problème peut se situer n’importe où sur ce chemin de demande. Cela n’établit ni la disponibilité globale du transporteur ni l’état du colis.

Puis-je afficher le dernier statut connu après une expiration ?

Oui, si vous le présentez comme la dernière information disponible et non comme une actualisation en direct réussie. Affichez l’heure de l’événement et l’heure de récupération lorsqu’elles sont connues, et précisez qu’une mise à jour plus récente n’a pas pu être confirmée.

Une expiration doit-elle faire passer un envoi de « en transit » à « exception » ?

Non. Une expiration est un échec de demande, pas un événement d’envoi. Ne modifiez le statut de l’envoi que lorsqu’une source de suivi fiable fournit un événement ou un statut justifiant ce changement.

Que faire si la demande ayant expiré créait ou enregistrait un enregistrement de suivi ?

Ne supposez pas qu’elle a échoué. Le système distant peut l’avoir traitée avant la perte de la réponse. Recherchez un résultat existant et utilisez un mécanisme d’idempotence documenté ou une procédure de récupération approuvée par le fournisseur avant de la soumettre à nouveau.

Sources