Формат файлов Swagger, официально известный как OpenAPI Specification (OAS), представляет собой машиночитаемый язык описания интерфейсов, предназначенный для проектирования, создания, использования и визуализации RESTful веб-сервисов. Изначально разработанный компанией SmartBear Software, этот формат позволяет разработчикам определять полную структуру API, включая доступные конечные точки (endpoints), параметры операций, методы аутентификации и схемы ответов. Благодаря использованию стандартизированного формата, файлы Swagger обеспечивают автоматическую генерацию документации, создание клиентских библиотек на различных языках программирования и автоматизированное тестирование. Формат обычно записывается в виде JSON или YAML, что делает его удобным как для чтения человеком, так и для машинного анализа. Он служит своего рода «чертежом» для API, гарантируя, что команды фронтенда и бэкенда имеют четкое общее представление о поведении сервиса. Это минимизирует ошибки интеграции и ускоряет жизненный цикл разработки за счет применения подхода «контракт прежде всего» (contract-first) при проектировании API. Swagger широко принят в индустрии программного обеспечения как стандарт для документации и дизайна RESTful API и поддерживается обширной экосистемой инструментов для тестирования, создания заглушек (mocking) и развертывания.