ASP.NET Web API documentation using Swagger – Useful links

Some of good additions to Swagger might be quite difficult to search so I put useful links here:

Generating model examples:

https://mattfrear.com/2015/04/21/generating-swagger-example-responses-with-swashbuckle #1
https://mattfrear.com/2016/01/25/generating-swagger-example-requests-with-swashbuckle #2
https://github.com/mattfrear/Swashbuckle.Examples

Description representation

It is possible to render really cool description in Swagger UI using Github markdown, for example nice table:

Open API spec

Open API spec
https://swagger.io/docs/specification/adding-examples/

This entry was posted in Documentation, WEB API and tagged , . Bookmark the permalink.

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s