OpenAPI (Swagger) описывает REST API — схемы, пути и аутентификацию для документов и генератора кода.
Спецификации OpenAPI 3.x YAML/JSON определяют пользовательский интерфейс Swagger, клиентские SDK и контрактные тесты. Компоненты повторно используют схемы; серверы перечисляют базовые URL-адреса для каждой среды.
Синхронизируйте спецификации с реализацией — отклонения ломают потребителей. Tentaco OpenAPI Validator и Mock Generator анализируют спецификации и локально пробуют JSON.