Attraper les erreurs du connecteur HTTP

Comprendre les cas d'utilisation d'une erreur de connecteur API HTTP, ainsi que la manière d'enregistrer l'erreur et de réessayer la fonction du connecteur.

Types d'erreurs du connecteur HTTP

La norme du protocole HTTP comprend l'exigence d'un code et d'un message de réponse du serveur, connus sous le nom de code de réponse HTTP et de message de réponse HTTP. Il existe des classes de code de réponse HTTP standard, ou des catégories, pour aider les utilisateurs finaux à indiquer intuitivement le type d'erreur qui s'est produit.
Ces classes de codes sont les suivantes : * 1xx - réponse informativeLa demande a été reçue, le processus se poursuit * 2xx - réussiteLa demande a été reçue, comprise et acceptée * 3xx - redirectionUne action supplémentaire doit être entreprise pour compléter la demande * 4xx - erreur du clientLa demande contient une mauvaise syntaxe ou ne peut être satisfaite * 5xx - erreur du serveurLe serveur n'a pas réussi à satisfaire une demande apparemment valide.

Le code d'erreur le plus courant que l'on peut rencontrer est 404 - Non trouvé ou 500 - Erreur interne du serveur. Ces codes d'erreur peuvent indiquer que le serveur du système externe est en panne, qu'il y a une maintenance en cours, qu'il y a un problème avec le service ou qu'il y a un problème de réseau.

Exemple : Capturer les erreurs HTTP dans une application

L'exemple suivant explique comment configurer une application pour qu'elle affiche les erreurs de la fonction de connecteur HTTP.

Création de la fonction de connecteur

Dans le constructeur de la fonction de connecteur, vous pouvez mapper le code d'erreur HTTP et le message d'erreur dans la configuration du connecteur Output. Cela passera le code d'erreur HTTP et le message d'erreur en tant que sorties de la fonction de connecteur pour être utilisés plus tard dans les applications Tulip.

1. Mettez en correspondance les champs d'état HTTP avec les sorties.
2. Donnez aux sorties un nom clair et distinct et relancez la fonction du connecteur pour tester si la sortie apparaît correctement.

Cela ressemblera à l'exemple suivant :

Créer une application pour gérer les erreurs du connecteur

Utilisez les informations des sorties du connecteur dans des applications pour gérer les erreurs du connecteur.

Exécuter le connecteur dans un déclencheur d'application

Créez une action de déclenchement avec Run Connector Function. Sélectionnez le connecteur et la fonction que vous venez de construire, puis enregistrez le résultat en tant que Variable.

Le code de réponse HTTP et le message sont maintenant disponibles en tant que référence dans la nouvelle variable de l'application.

Visualiser la réponse du connecteur dans une application

Placez un widget Variable sur une application Step qui affiche l'intégralité de la variable Connector Response.

Création d'un déclencheur de gestion des erreurs du connecteur

Ensuite, vous pouvez utiliser le code de réponse HTTP pour effectuer une gestion des erreurs au niveau de l'application sur une condition de déclenchement ultérieure.

1. Créez un nouveau déclencheur pour gérer les erreurs du connecteur.
2. Créez une condition qui recherche les codes de réponse HTTP incorrects. Dans cet exemple, la condition recherche les réponses qui ne sont pas égales à 200.:::(Info) (Remarque) De nombreux systèmes utilisent un code de réponse 200 comme une bonne réponse, mais il est préférable de vérifier auprès du fournisseur du point de terminaison de l'API ou du service informatique si toutes les bonnes réponses sont uniquement de code 200 :: :
3. Créez une action de déclenchement qui se produit lorsque la condition est remplie, c'est-à-dire lorsque le code de réponse HTTP est mauvais.

Voici à quoi cela ressemble dans l'application :

Pour en savoir plus

• Comment créer et configurer une fonction de connecteur HTTP
• Comment formater les sorties d'un connecteur HTTP
• Utilisation des connecteurs HTTP dans les applications