Les problèmes de délai d'attente (timeout) de l'API surviennent lorsqu'une requête ne reçoit pas de réponse dans le délai attendu. Ils peuvent être causés par les conditions réseau, le volume de requêtes, la configuration de l'intégration, la disponibilité du service ou la complexité de la requête traitée.
Symptômes courants
- la requête échoue après une période d'attente ;
- l'intégration signale une erreur de timeout ;
- les timeouts se produisent uniquement depuis un environnement ou un réseau ;
- les timeouts surviennent de manière intermittente ;
- les lots volumineux ou les requêtes répétées sont plus souvent affectés que les requêtes uniques.
Que vérifier en premier
- Confirmez l'endpoint et l'environnement utilisés par la requête.
- Vérifiez si le timeout se produit systématiquement ou seulement à des moments précis.
- Testez la même requête depuis un autre environnement ou réseau si possible.
- Passez en revue les changements récents d'infrastructure, de proxy, de pare-feu ou de réseau.
- Vérifiez si le volume de requêtes ou le comportement de nouvelle tentative a changé récemment.
Bonnes pratiques d'intégration
- Définissez des valeurs de timeout raisonnables dans votre application.
- Évitez les boucles de nouvelle tentative agressives qui peuvent augmenter le trafic pendant les incidents.
- Journalisez les horodatages des requêtes, les endpoints, les codes de statut et les temps de réponse.
- Distinguez les erreurs réseau transitoires des échecs de service répétés.
Quand contacter le support DQE
Si les timeouts sont fréquents ou affectent la production, créez un ticket de support avec l'endpoint, l'environnement, l'horodatage de la requête, la fréquence du problème, un exemple de requête, la réponse ou le message d'erreur, ainsi que tout changement récent de réseau ou de déploiement.