2026-05-18 · Lectura de 1 min
Valida OpenAPI antes de cada release
Detecta contratos rotos a tiempo: rutas faltantes, bloques info o deriva de versión.
OpenAPIAPICI
Conclusiones clave
- La validación estructural no sustituye tests de esquema de respuesta, pero bloquea fallos obvios de envío.
- Mantén un archivo spec canónico por servicio; valida el mismo artefacto que publicas.
Por qué validar en CI
Specs rotas rompen codegen, portales de documentación y gateways API en cascada.
Un pase estructural rápido ahorra horas cuando falta el objeto paths en docs de producción.
Flujo de trabajo
Pega JSON o YAML en OpenAPI Validator tras fusionar ramas de funcionalidad.
Si es válido, revisa rutas críticas con HTTP Request usando la misma URL base y autenticación.
Preguntas frecuentes
¿Valida ejemplos de respuesta?
Comprueba la forma del contrato de nivel superior; añade contract tests para ejemplos de payload y códigos de estado.
¿Soporte Swagger 2.0?
Aplican comprobaciones estructurales básicas; migra a OpenAPI 3 cuando sea posible para tooling más rico.