Llamar a una API externa

Llama a una API de transferencia de estado representacional (REST) autenticada, gestiona la respuesta y extrae datos para los nodos de flujo de trabajo posteriores.

Lo que crearás: un flujo de trabajo que llama a una API de transferencia de estado representacional (REST) autenticada, gestiona la respuesta y pone los datos extraídos a disposición de los nodos posteriores. Este es uno de los patrones más comunes en Flow: se aplica a cualquier sistema que expone un punto final HTTP.

Qué necesitará

• Una cuenta de UiPath Automation Cloud con acceso a Maestro Flow.
• La URL base de la API de destino, la ruta del punto final y los detalles de autenticación (clave de API, token al portador o credenciales de autenticación básicas).

Nodos utilizados

• Desencadenador manual : inicia el flujo de trabajo bajo demanda
• Solicitud HTTP : llama a la API REST
• Transformación de datos : extrae los campos que necesitas de la respuesta
• Script : registra los fallos en la ruta de error de la solicitud HTTP

Pasos

1. Crea un nuevo flujo y añade un desencadenador

1. Abre Maestro → Flow y crea un nuevo flujo de trabajo.
2. Arrastra un Desencadenador manual al lienzo.

2. Añade y configura el nodo de solicitud HTTP

1. Arrastra un nodo Solicitud HTTP al lienzo y conéctalo al desencadenador.
2. En el panel de configuración:
   • Establece Método en el verbo adecuado (GET, POST, PUT, PATCH o DELETE).
   • Introduce la URL completa del punto final.
   • En Encabezados, añade encabezados de autenticación y de tipo de contenido.

Para la autenticación de clave API:

Añade un encabezado con la clave Authorization y el valor Bearer {{ secret.apiKey }}. El prefijo secret. le dice a Flow que busque el valor en tu almacén de variables seguro; nunca pegues la clave directamente en el campo.

Para la autenticación básica:

Añade un encabezado con la clave Authorization y el valor Basic {{ secret.encodedCredentials }}, donde encodedCredentials es la cadena username:password codificada en base64.

3. Extrae los datos que necesitas

1. Arrastra un nodo Transformación de datos al lienzo y conéctalo al nodo de solicitud HTTP.
2. En el panel de configuración, asigna los campos de respuesta que necesitas de $vars.httpRequest1.output.body a variables de salida con nombre.

Por ejemplo, para extraer el nombre y el correo electrónico de un usuario de una respuesta como { "user": { "name": "Alex", "email": "[e-mail]" } }, asigna:

• $vars.httpRequest1.output.body.user.name → userName
• $vars.httpRequest1.output.body.user.email → userEmail

4. Añadir gestión de errores

1. Selecciona el nodo Solicitud HTTP.
2. Arrastra desde su controlador de error (el conector inferior derecho) a un nuevo nodo de Script .
3. En el nodo Script, registra el error de $vars.httpRequest1.error:

const error = $vars.httpRequest1.error;
console.log('API call failed:', error.message, '| Status:', error.status);
return null;

5. Probar y depurar

Selecciona Prueba. En el seguimiento de ejecución:

• Comprueba la salida statusCode del nodo de solicitud HTTP. 200 significa éxito; 401 significa que tu autenticación es incorrecta; 404 significa que la URL es incorrecta.
• Comprueba la salida del nodo Transformación de datos para confirmar que los campos se han extraído correctamente.
• Para probar la ruta de error, establece temporalmente la URL en un valor no válido y verifica que la ruta de error se ejecute.

Resultado

Tu flujo de trabajo llama a la API REST, extrae los campos que necesitas de la respuesta y registra los fallos en la ruta de error. Puedes inspeccionar el código de estado HTTP y los valores extraídos en el seguimiento de ejecución, y confirmar que tanto las rutas de éxito como las de error funcionan como se espera.

Ampliar este flujo de trabajo

• Manejar la paginación: si la API devuelve resultados en varias páginas, añade nodos de solicitud HTTP de seguimiento para obtener páginas adicionales, ramificándose con una decisión sobre si la respuesta incluye un cursor de página siguiente.
• Escribir resultados en otro sistema: después del nodo Transformación de datos, añade otro nodo de solicitud HTTP o un nodo de integración para enviar los datos en sentido descendente.
• Programarlo: reemplaza el Desencadenador manual por un Desencadenador programado para ejecutar el flujo de trabajo en un intervalo regular.