Есть ли генераторы, которые поддерживают OpenAPI 3?
на момент написания этой спецификации OpenAPI 3 является относительно новым. Я изо всех сил пытаюсь найти генераторы документации, которые поддерживают версию 3.0.
кто-нибудь знает генераторы, которые поддерживают OpenAPI v3.0?
3 ответов
вы можете попробовать OpenAPI Generator (https://openapi-generator.tech), который поддерживает OpenAPI spec v2, v3 и выпустил стабильную версию (3.0.0) несколько дней назад.
используя docker, вы можете легко создать документацию API:
docker run --rm -v ${PWD}:/local openapitools/openapi-generator-cli generate \
-i https://raw.githubusercontent.com/openapitools/openapi-generator/master/modules/openapi-generator/src/test/resources/2_0/petstore.yaml \
-g html2 \
-o /local/out/html2
вы найдете актуальный список инструментов и библиотек в Урр реализации документа найдено в GitHub.
несколько новых разработок, чтобы добавить:
- RepreZen API Studio теперь поддерживает OpenAPI-генератор, упомянутый выше Уильямом. (Примечание: Я работаю на RepreZen.)
- OpenAPI.Инструменты - еще один отличный ресурс для OpenAPI V3-совместимых редакторов, генераторов, форматов doc и других инструментов.