JanIA Automation API: del cambio de contrato al test, en minutos
JanIA Automation API es una suite que automatiza el ciclo completo de evolución de una API, desde la persistencia de especificaciones en una base de datos compartida hasta la comparación de versiones, detección de breaking changes y generación automática de tests ejecutables en múltiples formatos con IA. Te contamos cómo funciona y sus beneficios.
El reto
Cada nueva versión de una API no debería convertirse en un cuello de botella para toda la organización. Sin embargo, cuando no existe una gestión eficiente del cambio, el impacto se propaga rápidamente: QA debe rehacer gran parte de su batería de pruebas, los equipos consumidores descubren los breaking changes demasiado tarde y los costes de coordinación se disparan a medida que crece el número de integraciones. El resultado es una entrega más lenta, mayor fricción entre equipos y un aumento del riesgo operativo.
- Breaking changes invisibles: Cambios aparentemente pequeños —como una modificación en la paginación o un campo que pasa a ser obligatorio— no se detectan a tiempo y terminan descubriéndose cuando una integración falla directamente en producción.
- Tests que envejecen: Las colecciones de Postman, JMeter o Java quedan rápidamente ligadas a una versión específica de la API. Mantenerlas y actualizarlas manualmente supone un alto coste y ralentiza la evolución de los equipos.
- Coordinación: Cada equipo productor de APIs debe sincronizarse con todos los consumidores ante cualquier cambio. A medida que la organización crece, el esfuerzo de comunicación, validación y handover aumenta de forma exponencial, ralentizando la entrega y multiplicando la complejidad operativa.
- Sin trazabilidad de coste: Generar tests con IA puede parecer económico, pero la mayoría de los equipos no tiene visibilidad real sobre el coste de cada sesión, ejecución o iteración. Sin métricas claras, optimizar el uso y escalar la adopción se vuelve mucho más difícil.
Flujo end-to-end
Una base de datos compartida que centraliza todas las versiones de cada API y convierte el cambio en un proceso controlado, trazable y automatizable. Sobre esta capa común se construyen cinco pasos que cubren todo el ciclo de vida: desde la detección de cambios hasta la generación y validación automática de tests.
| 1 | Persistencia de especificaciones en base de datos El sistema procesa automáticamente definiciones OpenAPI y transforma endpoints, parámetros, esquemas y respuestas en un modelo relacional centralizado. Esto permite versionar, consultar y comparar APIs de forma estructurada y escalable. |
| 2 | Comparación automática entre versiones Detecta de forma inteligente endpoints añadidos, eliminados o modificados entre distintas versiones de una API, identificando además los breaking changes mediante reglas configurables y adaptadas a cada organización. |
| 3 | Reporting multi-formato: genera automáticamente informes en HTML, PDF y JSON Vista ejecutiva del nivel de riesgo, comparativas visuales side-by-side con diferencias resaltadas y una salida estructurada en JSON lista para integrarse en los siguientes pasos del pipeline. |
| 4 | Generación de tests con IA El sistema aplica cinco estrategias en paralelo —happy path, validación, seguridad, edge cases y casos básicos— para cubrir de forma integral cada cambio de la API. Además, los tests se generan en múltiples formatos de manera simultánea, mientras que el coste de cada sesión se registra y persiste en la base de datos para garantizar trazabilidad y control económico. |
| 5 | Ejecutar contra API en vivo Los tests se ejecutan directamente sobre la API real a través del proyecto Java generado, integrándose con Surefire para capturar resultados de forma estructurada. Cada caso —incluyendo estado, errores y mensajes de fallo— se parsea y se persiste en la base de datos, asegurando trazabilidad completa del comportamiento en producción. |
Ventajas
Seis ventajas clave que transforman la forma en la que los equipos construyen, validan y mantienen APIs desde el primer día.
| Testing en minutos, no en días | Una única fuente | Control total de breaking changes | Visibilidad completa del coste de IA | Generación multi-formato sin esfuerzo | Flexibilidad total en IA |
|---|---|---|---|---|---|
| Genera baterías completas de tests ejecutables en menos de 10 minutos. Lo que antes requería coordinación entre equipos de API y QA durante días, ahora se resuelve en un único flujo automatizado. | Todas las versiones de todas las APIs centralizadas en una sola base de datos. Cualquier equipo puede consultar, comparar y reutilizar información en tiempo real, sin duplicidades ni inconsistencias. | Cada cambio incompatible se detecta y se documenta automáticamente en reportes visuales (en formatos HTML y PDF), listos para auditoría, seguimiento o integración directa en tickets. | Cada ejecución registra consumo de tokens y coste estimado. Métricas listas para integrarse en dashboards como Grafana o Metabase, aportando transparencia total sobre el uso de IA. | Una sola sesión produce automáticamente artefactos en Java, Postman, Insomnia, JMeter y JSON. Cada equipo trabaja directamente en su formato preferido, sin conversiones manuales | Compatible con múltiples proveedores o modelos de Inteligencia Artificial como OpenAI, Claude y Gemini. Cambia de modelo sin alterar tu lógica ni interrumpir el flujo de trabajo. |
Antes vs. después
| sin la suite (manual) | con la suite (automatizado) |
|---|---|
| – Las nuevas versiones de la API llegan por email con changelogs difíciles de procesar. – QA debe interpretar cambios y reescribir tests manualmente en herramientas como Postman. – Los equipos consumidores suelen enterarse tarde de los breaking changes. – No existe un ecosistema unificado de pruebas (JMeter, Java, etc.), todo se construye de forma aislada. – El uso de IA no está optimizado ni trazable en costes. – Los fallos en producción se detectan tarde, normalmente en post-mortem. | – Cada nueva versión se persiste y se hace visible para todos los equipos en tiempo real. – Genera reportes enriquecidos (HTML, PDF, JSON) con los breaking changes claramente destacados. – Los consumidores reciben automáticamente los cambios como artefactos integrados en el pipeline. – Una sola ejecución de IA genera de forma consistente Postman, Insomnia, JMeter, Java y JSON. – El uso de IA queda completamente trazado, incluyendo costes y consumo de tokens. – Valida automáticamente los tests contra la API en vivo antes de cualquier despliegue. |
Nuevas posibilidades
Lo que hemos construido es solo el punto de partida. Esta arquitectura abre la puerta a una evolución continua, con mejoras ya diseñadas en el roadmap que llevan el sistema a un nuevo nivel de automatización e inteligencia.
| planificado Automatización CI/CD con generación de PRs | planificado Soporte avanzado para monorepos | planificado Despliegue en entornos self-hosted |
|---|---|---|
| Cada nueva versión de una API activa un flujo completamente automatizado: detección del cambio, análisis, generación de patch y creación de pull requests en todos los repositorios consumidores. Menos fricción, más velocidad, cero trabajo manual repetitivo. | Los monorepos requieren inteligencia adicional. Evolucionamos hacia un sistema de marcadores más expresivo que permite identificar y mapear automáticamente cada contrato dentro de estructuras complejas. | Libertad total de infraestructura. Soporte para modelos como Ollama, vLLM y llama.cpp en entornos privados, garantizando control total sobre el código y los datos sin depender de servicios cloud externos. |
| planificado Evolución hacia APIs modernas: gRPC y Protobuf | planificado Soporte para arquitectura de eventos (AsyncAPI) | planificado Calidad garantizada con tests del core |
|---|---|---|
| Ampliamos el análisis de cambios a contratos gRPC y Protobuf, extendiendo la inteligencia del sistema más allá de REST. Un mismo motor, nuevos protocolos, mayor cobertura. | Detectamos y analizamos cambios en sistemas event-driven como Kafka, RabbitMQ o WebSocket, manteniendo consistencia en entornos distribuidos y altamente dinámicos. | Reforzamos la base del sistema con una cobertura completa de pruebas en componentes clave , asegurando estabilidad y escalabilidad a largo plazo. |
Encaja en el portfolio de MTP
La suite se alinea de forma natural con los servicios que MTP ya ofrece a sus clientes:
