Pregunta

He estado buscando diferentes opciones para proporcionar la documentación de API generada automáticamente y parece que Swagger está ahí arriba.

Sin embargo, al probar esto por primera vez, recibo excepciones al inicio.

Running Visual Studio 2013.
Crea un nuevo proyecto de API web.
Usando el Administrador de paquetes, Ejecute:

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

asegurándose de que hemos habilitado la documentación XML, obtenemos esta excepción:

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.

¿Alguien más sabe de un paso que nos falta?Encontramos y seguimos esto:

https://github.com/swaggest-net/swagger.net/wiki
https://github.com/swaggest-net/swagger.net/blob/master/README.MD

¿Fue útil?

Solución

Swagger no admite .NET 4.5: tuvo que sacar el código fuente de GIT y modificarlo para trabajar con 4.5.

Haga clic derecho en el proyecto y configure el marco de destino allí

Otros consejos

He hecho una biblioteca para usar con MVC que genera la documentación para usted según los atributos.Puede ser lo que buscas.

Hay dcumentación en el repositorio en GitHub, simplemente haga clic en el enlace del sitio del proyecto.Espero que esto ayude a

Intenta usar swashbuckle.

Basado en Swagger hasta donde sé y funcionó la primera vez para mí ...

https://github.com/domaindrivendev/swashbuckle

Licenciado bajo: CC-BY-SA con atribución
No afiliado a StackOverflow
scroll top