Как создать спецификацию OpenApi 3.0 из существующего приложения Spring Boot?

Question

У меня есть проект (Spring Boot App + Kotlin), для которого я хотел бы иметь спецификацию Open API 3.0 (желательно на YAML).Библиотеки Springfox хороши, но они генерируют Swagger 2.0 JSON.Каков наилучший способ создания спецификации Open Api 3.0 из аннотаций в моих контроллерах?Единственный способ написать это с нуля?

Answer 1

Вы можете посмотреть spring-restdocs и restdocs-api-spec .

spring-restdocs использует основанный на тестировании подход к документации API, который имеет много преимуществ по сравнению с подходом, основанным на интроспекции, который использует spring-fox. restdocs-api-spec - это расширение для spring-restdocs, которое добавляет поддержку спецификации API. В настоящее время он поддерживает OpenAPI2 OpenAPI3 и Postman.