API Report
Se ha habilitado un nuevo botón para generar un informe 360 de la API. El informe incluye:
- Información global.
- Resumen de la API (Briefing).
- Información sobre la calidad de la definición.
- Información de tests funcionales.
- Información de tests de rendimiento.
- Información de tests de seguridad.
- Información de Mocking.
- Comentarios de la persona que genera el informe.
AWS API Gateway
Se ha creado un nuevo ciclo de vida para AWS API Gateway:
- AWS: Initializer: permite configurar la API para que pueda ser desplegada en AWS API Gateway.
- Deployer: permite desplegar la API en AWS.
- Promoter: permite mover el proyecto a otro entorno.
- Synchronizer: permite sincronizar la API con APIQuality.
Azure API Management
Se ha creado un nuevo ciclo de vida para Azure API Manager:
- Azure: Initializer: permite configurar la API para su despliegue.
- Azure: Deployer: permite desplegar la API en el servicio.
- Azure: Promoter: permite promocionar el proyecto a otros entornos.
- Azure: Synchronizer: permite la sincronización con APIQuality.
Mapeo de propiedades en la pestaña de API
Se ha añadido una nueva funcionalidad en el resumen de la API (ficha de API) que permite mapear campos a propiedades específicas de la API.
Nuevo cálculo de la puntuación de tests
A partir de ahora, la puntuación de calidad (scoring) se dividirá en dos sub-puntuaciones: densidad de tests y tasa de éxito.
Tasa de éxito (Success Rate)
Esta métrica evalúa el comportamiento real de los escenarios definidos:
- 100% – Verificado (A): Todos los escenarios se comportan según lo esperado.
- 95% – 99% – Estable (B): Existen problemas menores, pero la funcionalidad principal es sólida.
- 80% – 94% – Degradado (C): Fallan funciones significativas; no se recomienda para producción.
- 50% – 79% – Inestable (D): La API no es fiable; requiere un desarrollo profundo.
- < 50% – Crítico (E): Fallan más elementos de los que funcionan.
Puntuación por Densidad de Tests (Test Density)
Fórmula:
- < 1.0 -> Crítico (D): Pruebas insuficientes. Algunos endpoints no tienen cobertura.
- 1.0 – 2.5 -> Básico (C): Probablemente solo se cubren los «Happy Paths» (flujos ideales).
- 3.0 – 5.0 -> Saludable (B): Buena cobertura de éxito, errores y estados de validación.
- > 5.0 -> Robusto (A): Alta confianza; incluye casos de borde (edge cases) y pruebas de límites de seguridad.
Puntuación Final (Final Score)
Cálculo:
- 95 – 100 -> A (Listo para producción): Altamente fiable con una cobertura de tests profunda.
- 85 – 94 -> B (Estable): Buena cobertura, pero con fallos menores o pruebas insuficientes en áreas aisladas.
- 70 – 84 -> C (Aviso): Brechas significativas en las pruebas o demasiados fallos en «casos de borde».
- 50 – 69 -> D (Inestable): Riesgo alto; la API no tiene suficientes pruebas y falla con frecuencia.
- < 50 -> F (Insuficiente): Nivel de tests críticamente bajo o la mayoría de los tests fallan.
Resultados de tests funcionales en el panel de puntuación
Se ha añadido la visualización de los tests y sus resultados directamente desde la pantalla de puntuación (scoring).
Puntuación de rendimiento (Performance scoring)
Se ha revisado la puntuación de rendimiento para optimizar su funcionamiento.
Reglas por defecto en la guía de estilo
Se han revisado las reglas de estilo para que solo las reglas esenciales se activen automáticamente al crear una nueva organización:
Bugs y pequeñas mejoras
Mejoras menores:
- Se ha eliminado la sección de OpenApidiff en el informe 360.
- Se ha mejorado la pantalla de listado de modelos para permitir la copia de la URL cuando el texto desborda el contenedor.
- Se ha revisado el algoritmo de nomenclatura de ramas (branch naming).
Bugs:
- Corregido un error menor que ocultaba el botón de importar APIs en el catálogo al aplicar filtros.
- Corregido un error que causaba el fallo al importar una API desde el API Hub.
- Solucionado el error que provocaba que el repositorio se quedara bloqueado en un indicador de carga infinito (spinner) cuando aún no había sido creado.