Captura de errores del conector HTTP

Comprende los casos de uso de la captura de un error del Conector API HTTP, así como la forma de registrar el error y reintentar la función del conector.

Tipos de errores del conector HTTP

El estándar del protocolo HTTP incluye el requisito de un código de respuesta del servidor y un mensaje, conocidos como Código de Respuesta HTTP y Mensaje de Respuesta HTTP. Con esto, hay clases de códigos de respuesta HTTP estándar, o categorías para ayudar a los usuarios finales a significar intuitivamente el tipo de error que se ha producido.Estas clases de códigos incluyen los siguientes:* 1xx - respuesta informativaLasolicitud fue recibida, continuando el proceso* 2xx - exitosoLasolicitud fue recibida con éxito, entendida y aceptada* 3xx - redirecciónEsnecesario tomar medidas adicionalespara completar la solicitud* 4xx - error del clienteLasolicitud contiene mala sintaxis o no se puede cumplir* 5xx - error del servidorElservidor no pudo cumplir con una solicitud aparentemente válida

El código de error más común que se puede encontrar es 404 - Not Found o 500 - Internal Server Error. Estos códigos de error pueden indicar que el servidor del sistema externo está caído, que hay mantenimiento en curso, que hay un problema con el servicio o que hay un problema de red.

Ejemplo: Capturar errores HTTP en una aplicación

El siguiente ejemplo detalla cómo configurar una aplicación para que muestre los errores de la función del conector HTTP.

Cree la función de conector

En el constructor de la función del conector, puede asignar el código de error HTTP y el mensaje de error en la configuración del conector Output. Esto pasará el Código de error HTTP y el Mensaje de error como salidas de la función del conector para su uso posterior en Tulip Apps.

1. Asigne los campos de estado HTTP a las salidas.
2. Asigne a las salidas un nombre claro y distinto y vuelva a ejecutar la función del conector para comprobar si la salida aparece correctamente.

Esto se parecerá al siguiente ejemplo:

Construir una aplicación para manejar los errores del conector

Utilice la información de las salidas del conector en apps para realizar la gestión de errores del conector.

Ejecute el conector en un disparador de aplicación

Cree una acción de activación con Ejecutar función del conector. Seleccione el conector y la función que acaba de construir, luego guarde el resultado como una Variable.

El Código de Respuesta HTTP y el Mensaje están ahora disponibles como referencia en la nueva variable de la app.

Visualizar la Respuesta del Conector en una App

Coloca un widget de Variable en un Paso de la app que muestre la variable completa de la Respuesta del Conector.

Construir el Trigger de Manejo de Errores del Conector

A continuación, puede utilizar el código de respuesta HTTP para realizar la gestión de errores a nivel de aplicación en una condición de trigger posterior.

1. Cree un nuevo disparador para realizar el Manejo de Errores del Conector.
2. Cree una condición que busque el código de respuesta HTTP que es incorrecto. En este ejemplo, la condición busca respuestas que no sean iguales a 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. Crear una acción desencadenante que se produzca cuando se cumpla la condición, cuando el código de respuesta HTTP sea incorrecto.

Esto es lo que parece en la aplicación:

Lecturas Adicionales

• Cómo crear y configurar una función de conector HTTP
• Cómo dar formato a las salidas del conector HTTP
• Uso de conectores HTTP en aplicaciones