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ódigo 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 informativaLa solicitud fue recibida, continuando el proceso * 2xx - exitosoLa solicitud fue recibida, entendida y aceptada con éxito * 3xx - redirecciónEs necesario realizar más acciones para completar la solicitud * 4xx - error del clienteLa solicitud contiene mala sintaxis o no se puede cumplir * 5xx - error del servidorEl servidor 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. Dé 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:

Crear una aplicación para gestionar 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

Construya una acción disparadora 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 aplicación.

Visualizar la respuesta del conector en una aplicación

Coloca un widget 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, puedes 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. Crea un nuevo disparador para realizar el Manejo de Errores del Conector.
2. Cree una condición que busque el código de respuesta HTTP incorrecto. En este ejemplo, la condición busca respuestas que no sean iguales a 200.:::(Info) (Nota) Muchos sistemas utilizan un código de respuesta 200 como una buena respuesta, pero es mejor comprobar con el proveedor del punto final de la API o con TI si todas las buenas respuestas serán sólo del código 200 :::
3. Cree una acción desencadenante que se produzca cuando se cumpla la condición, cuando el código de respuesta HTTP sea malo.

Este es el aspecto de 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