FinImpulse API Sandbox: pruebas sin costes en producción
Una descripción técnica del entorno Sandbox de FinImpulse, desde el acceso al token hasta las pruebas de integración.
Integrar una API de datos financieros requiere un considerable trabajo de exploración, que incluye validar los esquemas de respuesta, probar configuraciones de peticiones y depurar la lógica de la aplicación. Sin embargo, hacerlo en un entorno de producción resulta caro e ineficiente.
Para resolver esto directamente, la API de FinImpulse incluye ahora un entorno Sandbox que ofrece a los desarrolladores un espacio dedicado para completar todo el proceso de integración sin coste alguno.
Qué es el Sandbox de FinImpulse
El Sandbox de FinImpulse es un entorno de pruebas que permite a los desarrolladores enviar peticiones a cualquier endpoint de la API de FinImpulse y recibir respuestas estructuradas sin coste. Está disponible para cualquier usuario registrado y no requiere un plan aparte ni ninguna configuración adicional más allá de obtener el token de API del Sandbox.
Todas las respuestas que devuelve el Sandbox contienen datos ficticios. Estos datos no reflejan valores reales del mercado y no deben utilizarse con fines analíticos ni de negocio. Sin embargo, la estructura y los campos de cada respuesta del Sandbox son idénticos a los de la respuesta de la API de producción, lo que lo convierte en un entorno coherente y predecible para el desarrollo previo a la producción.
Cómo trabajar con el Sandbox de FinImpulse
El Sandbox utiliza la URL base estándar de la API de FinImpulse — api.finimpulse.com. No es necesario realizar cambios en la estructura de la petición, en las cabeceras ni en las rutas de los endpoints. La única diferencia entre una petición al Sandbox y una petición a producción es el token de API que se utiliza.
El token de API del Sandbox es un token independiente y fijo disponible en la pestaña API Settings, dentro de API Mode, en el panel de FinImpulse.
Para enviar peticiones al Sandbox, sustituya el token de API de producción por el token de API del Sandbox en la cabecera Authorization. No es necesario realizar ningún otro cambio en la petición.
Casos de uso del Sandbox de FinImpulse
El Sandbox puede cubrir los escenarios principales que surgen durante la integración de la API, desde la configuración inicial hasta la validación previa a producción.
Formato de peticiones y autenticación
El Sandbox devuelve los mismos códigos y mensajes de error que en producción ante peticiones mal formadas, parámetros obligatorios ausentes y configuraciones de token no válidas. Los desarrolladores pueden verificar que las cabeceras Authorization tienen la estructura correcta, que los campos obligatorios están presentes y que los parámetros opcionales —incluidas las expresiones de filtro, las configuraciones de ordenación y los parámetros de paginación— tienen el formato correcto antes de realizar llamadas en producción.
Procesamiento y estructura de las respuestas
El Sandbox devuelve respuestas con el mismo esquema que en producción. Esto permite a los desarrolladores verificar que el código de la aplicación lee correctamente los nombres de los campos, gestiona los objetos anidados y procesa los tipos de datos según lo previsto, sin necesidad de realizar llamadas a la API en producción.
Para los endpoints que devuelven tipos de registro mixtos en un único array, como el endpoint de precios históricos, el Sandbox permite validar que la lógica de enrutamiento por tipo está correctamente implementada.
Lógica de paginación
Algunos endpoints utilizan la paginación basada en tokens mediante el “search_after_token”. El Sandbox permite verificar que la paginación está correctamente implementada, incluida la gestión del caso en que el “search_after_token” es null, lo que indica que se ha llegado a la última página.
Pipelines de pruebas automatizadas
El Sandbox puede utilizarse en pipelines de CI/CD y en suites de pruebas automatizadas para validar el formato de las peticiones y el procesamiento de las respuestas como parte del flujo de desarrollo estándar.
El Sandbox cubre todo el ciclo petición-respuesta en todos los endpoints de FinImpulse: desde la autenticación y la lógica de filtros hasta la paginación y el procesamiento de las respuestas. Una vez validada la integración, pasar a producción solo requiere sustituir el token del Sandbox por el token de API de producción.
