Что такое Swagger и OpenAPI? В чем разница?

OpenAPI — это официальная спецификация (стандарт) для описания REST API. Она описывает, как должен выглядеть YAML или JSON файл с контрактом (эндпоинты, параметры, схемы ответов).

Swagger — это набор инструментов от компании SmartBear, которые работают со спецификацией OpenAPI.

• Swagger Editor: Браузерный редактор для написания YAML.


• Swagger UI: Инструмент, который берет OpenAPI YAML и рисует красивую интерактивную веб-страницу с документацией и кнопкой "Try it out".


• Swagger Codegen: Генератор серверных заглушек и клиентских SDK по YAML-файлу.