Question

Établi des différentes options pour fournir une documentation API générée automatiquement et Swagger semble être là-bas.

Cependant, lorsque j'essayez cela pour la première fois, je reçois des exceptions au démarrage.

Exécution de Visual Studio 2013.
Créer un nouveau projet d'API Web.
Utilisation du gestionnaire de paquets, exécutez:

Install-Package Swagger.Net & Install-Packager Swagger.Net.UI

Assurez-vous que nous activons la documentation XML, nous obtenons cette exception:

Method 'GetDocumentation' in type 'Swagger.Net.XmlCommentDocumentationProvider' 
from assembly 'Swagger.Net, Version=0.5.1.0, Culture=neutral, PublicKeyToken=null' 
does not have an implementation.

Quelqu'un d'autre sait-il une étape que nous manquons?Nous avons trouvé et suivi ceci:
https://github.com/swagger-net/swagger.net/wiki de
https://github.com/swagger-net/swagger.net/blob/master/readme.md

Était-ce utile?

La solution

Swagger ne prend pas en charge .NET 4.5 - Dûtir le code source de Git et la modifier pour travailler avec 4.5.

Cliquez avec le bouton droit de la souris sur le projet et définissez la structure cible là-bas

Autres conseils

J'ai fait une bibliothèque à utiliser avec MVC qui génère la documentation pour vous en fonction des attributs.C'est peut-être ce que vous recherchez.

Il existe un dcoummentation dans le référentiel sur GitHub, cliquez simplement sur le lien du site du projet.J'espère que cela aide

Essayez d'utiliser Swashbuckle.

Basé sur Swagger autant que je sache et cela a fonctionné pour moi pour moi ...

https://github.com/domaindrivendendr/swashbuckle

Licencié sous: CC-BY-SA avec attribution
Non affilié à StackOverflow
scroll top