Partager via

OpenApiSpecGeneratorPlugin

  • Article

Génère des spécifications OpenAPI au format JSON à partir des requêtes et réponses interceptées.

Capture d’écran de deux fenêtres d’invite de commandes. L’une affiche les demandes d’API d’enregistrement du proxy de développement. L’autre montre la spécification OpenAPI générée.

Définition de l’instance de plug-in

{
  "name": "OpenApiSpecGeneratorPlugin",
  "enabled": true,
  "pluginPath": "~appFolder/plugins/dev-proxy-plugins.dll",
  "configSection": "openApiSpecGeneratorPlugin"
}

Exemple de configuration

{
  "openApiSpecGeneratorPlugin": {
    "includeOptionsRequests": false,
    "specVersion": "v3_0"
  }
}

Propriétés de configuration

Propriété Description Default
includeOptionsRequests Détermine s’il faut inclure des OPTIONS demandes dans la spécification OpenAPI générée false
specVersion Détermine la version à utiliser pour la spécification OpenAPI générée. Peut être défini sur v2_0 ou v3_0 v3_0

Options de ligne de commande

Aucun(e)

Notes

Pour créer de meilleures spécifications OpenAPI, envisagez d’utiliser un modèle de langage local avec le proxy de développement. À l’aide d’un modèle de langage local, les OpenApiSpecGeneratorPlugin ID d’opération et les descriptions plus clairs génèrent un meilleur point de départ pour votre spécification OpenAPI. Pour utiliser un modèle de langue locale avec le OpenApiSpecGeneratorPluginmodèle de langue, activez le modèle de langue dans le fichier de configuration. Pour plus d’informations, consultez Utiliser un modèle de langue locale.