OpenApi по сути является дальнейшим развитием swagger, поэтому версия 3.0.0 вместо 1.0.0
Если вы читаете блог swagger Swagger был передан в инициативу OpenAPI, и все инструменты чванства, такие как editor.swagger.io, поддерживают openapi и преобразования между ними.
, когда они пишут
OpenAPI = Спецификация
Swagger = Инструменты для реализации спецификация
(и swagger также является термином для первых двух итераций spe c)
Если вы не ограничены конкретной c версией, я бы Рекомендую openapi, так как сообщество теоретически больше, и со времен swagger v. 2.0.0 много чего произошло , таких как упрощение и простота использования.
поддерживается больше схем безопасности , расширенные типы параметров, основанные на том, есть ли у вас путь, запрос, заголовок или повар ie.
Также улучшено определение примеров. Я участвовал в проекте, где нам хотелось бы использовать openapi вместо сваггера для этого резонанса, к сожалению, API GW еще не поддерживал его ...