Базовый
В чем разница между OpenAPI и Swagger?
OpenAPI — это официальная спецификация (стандарт) для описания REST API. Она описывает, как должен выглядеть YAML или JSON файл с контрактом (эндпоинты, параметры, схемы ответов).
Swagger — это набор инструментов от компании SmartBear, которые работают со спецификацией OpenAPI.
- Swagger Editor: Браузерный редактор для написания YAML.
- Swagger UI: Инструмент, который берет OpenAPI YAML и рисует красивую интерактивную веб-страницу с документацией и кнопкой "Try it out".
- Swagger Codegen: Генератор серверных заглушек и клиентских SDK по YAML-файлу.