¿En qué se diferencia OpenAPI de Swagger? ¿Qué versión estás usando?
sobes.tech AI
Respuesta de la IA
OpenAPI es una especificación para describir API RESTful, que permite estandarizar la descripción de interfaces de servicios web. Swagger, por otro lado, fue inicialmente una herramienta y un ecosistema para trabajar con API, incluyendo la generación de documentación, SDKs de cliente y plantillas de servidor.
En 2016, la especificación Swagger fue renombrada a OpenAPI Specification (OAS) y transferida a la gestión de Linux Foundation bajo la iniciativa OpenAPI. Actualmente, OpenAPI es un estándar, y Swagger es un conjunto de herramientas que soportan este estándar.
Se suele usar la última versión estable de OpenAPI Specification, que en 2024 es OpenAPI 3.1.x, ya que soporta una descripción más flexible, incluyendo compatibilidad total con JSON Schema.
Ejemplo de uso de OpenAPI 3.1: