OpenAPI 4 es la evolución del estándar más utilizado para describir APIs REST. Esta versión introduce cambios significativos en el formato, los tipos de datos y las capacidades de composición.
Novedades de OpenAPI 4
OpenAPI 4 adopta JSON Schema 2020-12 como base para la descripción de esquemas, reemplazando versiones anteriores de JSON Schema. Esto unifica la validación de datos entre la especificación de la API y los esquemas de datos.
Linting y validación automática: la nueva especificación incluye reglas de validación más estrictas que detectan inconsistencias antes de desplegar. Herramientas como Redocly, Spectral y Stoplight ya soportan OpenAPI 4.
Composición mejorada: los $ref y componentes reutilizables se han mejorado con soporte para polimorfismo, oneOf/anyOf más expresivos y herencia de esquemas.
Beneficios prácticos
Con OpenAPI 4, puedes generar clientes en 40+ lenguajes, documentación interactiva (Swagger UI, Redoc, Scalar), tests de contratos y mocks de servidor. La generación de tipos TypeScript desde la especificación elimina la duplicación entre documentación e implementación.
Herramientas del ecosistema
Herramientas como openapi-typescript generan tipos completos. OpenAPI-Generator produce SDKs. Zod puede validar requests contra esquemas OpenAPI en tiempo de ejecución.
OpenAPI 4 hace que diseñar, documentar y mantener APIs sea más fácil que nunca. En Vynta aplicamos OpenAPI 4 en todos nuestros proyectos API para garantizar consistencia y facilidad de integración.