La especificación OpenAPI (OAS), anteriormente conocida como especificación Swagger, es un estándar reconocido mundialmente para definir y documentar API RESTful. Un archivo .openapi sirve como una descripción de interfaz agnóstica al lenguaje que permite tanto a humanos como a máquinas descubrir y comprender las capacidades de un servicio web sin necesidad de acceder al código fuente subyacente. Estos archivos suelen estar estructurados utilizando YAML o JSON y contienen información detallada sobre los puntos finales (endpoints) de la API, incluyendo operaciones disponibles, parámetros de entrada, formatos de salida, requisitos de autenticación e información de licencias. Al utilizar este formato, los desarrolladores pueden implementar una metodología de diseño 'API-first', asegurando que la interfaz esté claramente definida antes de escribir cualquier código. Esto facilita la generación automatizada de documentación interactiva, kits de desarrollo de software (SDK) del lado del cliente, stubs de servidor y conjuntos de pruebas integrales. El formato es mantenido por la OpenAPI Initiative, un consorcio bajo la Linux Foundation, y se ha convertido en el estándar de la industria para el desarrollo web moderno, permitiendo una integración fluida entre sistemas dispares y mejorando la colaboración entre los equipos de ingeniería frontend y backend.