web-dev-qa-db-fra.com

Existe-t-il des générateurs prenant en charge OpenAPI 3?

Au moment de la rédaction de ce document, la spécification OpenAPI 3 est relativement nouvelle. J'ai du mal à trouver des générateurs de documentation prenant en charge la version 3.0.

Est-ce que quelqu'un connaît des générateurs prenant en charge OpenAPI v3.0?

swaggeropenapiopenapi-generator
8
MattC

Vous pouvez essayer OpenAPI Generator ( https://openapi-generator.tech ), qui prend en charge OpenAPI spec v2, v3 et a publié une version stable (3.0.0) il y a quelques jours.

À l'aide de docker, vous pouvez facilement générer la documentation de l'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
10
William Cheng

Vous trouverez une liste organisée d'outils et de bibliothèques dans le document Implémentations OAI disponible sur GitHub.

3
Mike

Quelques nouveaux développements à ajouter:

  • RepreZen API Studio supporte maintenant OpenAPI-Generator, référencé ci-dessus par William. (Remarque: je travaille pour RepreZen.)
  • OpenAPI.Tools est une autre excellente ressource pour les éditeurs, générateurs, formats de documentation et autres outils compatibles OpenAPI v3.
1
Ted Epstein

Un peu tard pour la soirée, je l’ai trouvé très utile pour les projets node.js express

oas-generator pour la spécification Open API 3.0: Link

0
tuggo