En las integraciones dinámicas, especialmente cuando se utilizan conectores HTTP en flujos de trabajo automatizados (como Cadenas), es fundamental gestionar eficazmente la respuesta de una llamada a la API. Los Parámetros de Resultado permiten a los usuarios capturar datos esenciales devueltos por la API -como el cuerpo de la respuesta, las cabeceras de la respuesta y el código de estado- para que estos datos puedan utilizarse en pasos posteriores.
¿Qué problema resuelve esto?
Los parámetros de salida son cruciales para crear flujos de trabajo receptivos e inteligentes.
- Flujos de trabajo dinámicos: Los parámetros de salida permiten adaptar lo que ocurre a continuación en función de lo que devuelve la API: por ejemplo, extraer un token, comprobar si existe un registro o confirmar una operación correcta.
- Automatizaciones: Al capturar los valores automáticamente, los usuarios evitan la entrada manual o la codificación rígida, lo que permite que los flujos de trabajo se amplíen con menos mantenimiento.
- Integraciones agilizadas: Conectar sistemas como servidores de autenticación, CRM o API personalizadas resulta más sencillo porque el conector se adapta en función de los datos que recibe.
¿A quién afecta esto?
- Desarrolladores e integradores: Los que construyen cadenas de automatización o integraciones entre sistemas.
- Analistas de datos: Aquellos que confían en flujos de datos precisos y en tiempo real para alimentar cuadros de mando o informes.
- Administradores del sistema: mantienen y solucionan los problemas de las integraciones. Tener acceso a los parámetros de salida ayuda a localizar las incidencias rápidamente.
¿Qué son los parámetros de resultado?
Los Parámetros de Salida en un Conector HTTP se utilizan para definir los resultados esperados de una solicitud HTTP, como las cabeceras de respuesta, el cuerpo de la respuesta o el código de respuesta. Definen los resultados esperados de una solicitud HTTP, que pueden reutilizarse en nodos o etapas lógicas posteriores de una cadena.
Ejemplo Parámetros de Resultado:
- Encabezados de respuesta: Metadatos como el tipo de contenido, el servidor o el estado del límite de velocidad.
- Cuerpo de la respuesta: El contenido real devuelto por la API, normalmente en formato JSON o XML.
- Código de respuesta: Indica si la operación tuvo éxito (200), error del cliente (400), error del servidor (500), etc.
Ejemplo: Captura de un token de acceso
Supongamos que una API devuelve un token como éste:
{ "token_type": "Bearer", "expires_in": 600, "access_token": "<access_token_string>", "scope": "graph:write graph_api|r permissions|w ..." }Puedes definir access_token como parámetro de salida, y luego pasarlo a la siguiente etapa (por ejemplo, para autenticar otra llamada a la API).
¿Por qué es necesario el Cuerpo de Respuesta?
El cuerpo de la respuesta es normalmente donde la API devuelve la información más importante. Pueden incluir, pero no se limitan a:
- ID de registros de nueva creación
- Tokens de autenticación
- Resultados de consultas o cargas útiles de datos
Sin acceso al cuerpo de la respuesta, estás limitado a los metadatos, lo que restringe lo dinámico que puede ser tu flujo de trabajo.
Ahora podemos obtener el access_token disponible en el desplegable Respuesta.
Escenarios comunes de tratamiento de errores
Incidencias típicas que puedes encontrar al trabajar con Parámetros de Resultado:
-
Se ha producido un error: parámetro de salida no definido
Causa y solución: La estructura del cuerpo de la respuesta ha cambiado o está anidada. Confirma la ruta JSON correcta al campo.
-
Error: 401 No autorizado
Causa y solución: Falta token o ha caducado. Asegúrate de que el token se captura y pasa correctamente.
-
Error: 500 Error interno del servidor
Causa y solución: Incidencia del servidor o carga no válida de la solicitud. Comprueba el cuerpo de la respuesta para obtener más contexto.
-
Error: JSON no válido
Causa y solución: La API devuelve una respuesta malformada. Utiliza un bloque Try-Catch o valida el resultado antes de analizarlo.
¿Qué es un token de portador y por qué es necesario?
Un Token de portador es un tipo de token de acceso utilizado en la autenticación OAuth 2.0. Autoriza a un usuario o a una aplicación a acceder a una API. Se llama "Portador" porque "llevas" el token en la cabecera de tu solicitud HTTP.
Encabezado de ejemplo:
Autorización: Portador <access_token>
Este token es más seguro que la autenticación básica porque:
- Caduca, reduciendo el riesgo de fugas de tokens.
- Puede llevar ámbitos y permisos.
- Separa la Autenticación de la Autorización.
¿Por qué no utilizar la Autenticación Básica?
Mientras que la autenticación básica envía un nombre de usuario y una contraseña codificados en cada solicitud:
- Es menos seguro: las credenciales se pueden reutilizar o interceptar.
- No puede caducar ni delimitar el acceso fácilmente.
- Carece de control de permisos basado en tokens.
Los tokens de portador admiten la caducidad, la actualización y los permisos granulares, lo que los convierte en la mejor opción para las API modernas y la seguridad de nivel empresarial.