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, appelés code de réponse HTTP et message de réponse HTTP. Il existe des classes de code de réponse HTTP standard, ou 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 informativeLademande a été reçue, le processus se poursuit* 2xx - réussiteLademande a été reçue, comprise et acceptée avec succès* 3xx - redirectionUneaction supplémentairedoit être entreprise pour compléter la demande* 4xx - erreur du clientLademande contient une mauvaise syntaxe ou ne peut pas être satisfaite* 5xx - erreur du serveurLeserveur 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 afficher 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 de 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 sur les 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 désormais disponibles en tant que référence dans la nouvelle variable d'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 effectuer la gestion des 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) (Note)
   Many systems use a 200 response code as a good response, but it is best to check with the API endpoint provider or IT if all good responses will only be of code 200
   :::
3. Créez une action de déclenchement qui se produit lorsque la condition est remplie, 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