web-dev-qa-db-fra.com

Comment générer un PDF ou balisage depuis OpenAPI 3.0?

J'ai une spécification OpenAPI 3.0 et je veux en générer un PDF afin qu'il puisse être donné aux utilisateurs finaux.

Actuellement, des outils comme swagger-spec-to-pdf ou swagger2markup ne prennent en charge que Swagger 2.0 mais pas OpenAPI 3.0. Est-il possible de générer un PDF à partir d'une spécification OpenAPI 3.0 sans le convertir en Swagger 2.0?

4
Niranjan

Je viens de trouver RapiPDF qui est capable de générer PDF à partir de la définition d'OpenAPI 3.0.

Mais ce n'est toujours pas l'outil idéal que je recherche. J'ai trouvé ces limitations jusqu'à présent:

  • Pas de CLI, ne fonctionne que dans le navigateur. Je ne peux donc pas l'utiliser dans un pipeline d'automatisation.
  • Le rappel n'est pas pris en charge
  • Aucun exemple dans le document généré
1
aleung

Voici une liste d'outils:

Mais je n'ai pas essayé tous/trouver un bon pour PDF et HTML5 et appelable via la ligne de commande, pour l'instant.

0
Markus