El formato de archivo Swagger, conocido formalmente como OpenAPI Specification (OAS), es un lenguaje de descripción de interfaz legible por máquina diseñado para describir, producir, consumir y visualizar servicios web RESTful. Creado originalmente por SmartBear Software, permite a los desarrolladores definir la estructura completa de una API, incluyendo puntos finales (endpoints) disponibles, parámetros de operación, métodos de autenticación y esquemas de respuesta. Al utilizar un formato estandarizado, los archivos Swagger facilitan la generación automatizada de documentación, la creación de bibliotecas cliente en diversos lenguajes de programación y la realización de pruebas automatizadas. El formato se escribe típicamente en JSON o YAML, lo que lo hace legible para los humanos y fácil de procesar para las máquinas. Sirve como un plano técnico para la API, asegurando que tanto los equipos de frontend como de backend tengan una comprensión clara y compartida de cómo debe comportarse el servicio. Esto reduce los errores de integración y acelera el ciclo de vida del desarrollo al proporcionar un enfoque de 'contrato primero' (contract-first) para el diseño de APIs. Es ampliamente adoptado en la industria del software como el estándar para la documentación y el diseño de APIs RESTful, respaldado por un vasto ecosistema de herramientas para pruebas, simulación (mocking) y despliegue.