ASP.NET Web API documentation using Swagger – Useful links

Posted on November 3, 2017 by

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:

Gravatar
WordPress.com Logo

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

Google+ photo

You are commenting using your Google+ 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 )

Cancel

Connecting to %s

This site uses Akismet to reduce spam. Learn how your comment data is processed.