Exportar datos desde Flex Insights a través de la API
Aprende a exportar informes desde Insights para almacenar los datos en un almacén propio con esta guía.
El proceso de exportación consta de los siguientes pasos:
- Iniciar sesión en la API para obtener un token supersecreto (SST)
- Obtener un token temporal (TT) utilizado para las llamadas posteriores a la API
- Exportar el informe
- Cerrar sesión
Requisitos previos
Antes de empezar a exportar datos, deberás contar con los siguientes elementos:
- Un espacio de trabajo de Flex Insights suministrado
- Las credenciales de un usuario con acceso al espacio de trabajo de Insights
- Un informe de tabla que contenga los datos que necesitas exportar
- Compatibilidad del cliente de la API REST con las cookies que se utilizan para pasar tokens de autenticación
Autenticación de la API
Asegúrate de que estás realizando la autenticación con la API de Flex Insights; para ello, comprueba que tengas un TT (token temporal) válido.
The procedure is detailed at API General Usage
Exportar el informe sin procesar
Exportar el informe sin procesar es útil para obtener datos que se puedan procesar de forma automática de cualquier informe creado a través del portal de análisis de Flex Insights. Necesitarás el ID del espacio de trabajo y el ID del objeto report para exportar los datos.
ID del espacio de trabajo: inicia sesión en el portal de análisis y revisa la URL en la barra de direcciones del navegador. Por ejemplo:
The workspace ID is the string appearing between the #s=/gdc/workspaces/ segment and the vertical bar. In this case, the workspace ID qx8vgewnj2hyemje8f6bkrkbyqk8psrf.
ID de objeto: en el portal de análisis, desplázate hasta el informe que deseas exportar y revisa la URL en la barra de direcciones. Podría tener este aspecto:
Object ID is the numerical expression at the very end of the URL and is typically preceded by obj/ segment. In the example above, Object ID is 643040.
El tamaño máximo del informe para las exportaciones sin procesar es de 1 GB. La exportación de un informe de este tamaño puede tomar minutos.
Descargar el informe
Descarga el informe mediante el URI de la exportación anterior.
Si recibes una respuesta 202 de la API, significa que la solicitud fue aceptada, pero no está lista para entregarse (todavía se está calculando o preparando el archivo CSV).
Como la API de exportación puede tardar varios segundos o minutos en casos periféricos, según el volumen de datos y la cantidad de columnas, debes agregar un reintento en caso de que el servidor devuelva 202. Los datos solo están listos para la descarga cuando el servidor devuelve 200.
¿Necesitas ayuda?
Todos la necesitamos a veces; la programación es difícil. Obtén ayuda ahora de nuestro equipo de soporte, o recurre a la sabiduría de la multitud visitando Stack Overflow Collective de Twilio o navegando por la etiqueta de Twilio en Stack Overflow.
