MakingSense / WebApiCore-Seed

MIT License

2 stars 5 forks source link

Issue8 swagger integration #9

Closed Dongata closed 6 years ago

Dongata commented 6 years ago

First PR on MS c:

Background

Implements swagger ui, with swashbuckle as a code generator

Changes done

ErrorDto is added, to have some kind of typing what our api recognizes as an error response.
ValidateModelResponseOperationFilter is a swagger definitition that is added to the final json for whatever endpoint that uses ValidateModel attribute.
On webapi csproject \<NoWarn>1701;1702;1705;1591\</NoWarn> was added, this is for warnings suppresions on xml comments (\<summary>), also the generator for that xml is added.

andresmoschini commented 6 years ago

Nice work @Dongata!

Swashbuckle does a really good work documenting .NET APIs easily. Could you include a screenshot to impress people that do not know this library?

Dongata commented 6 years ago

Demo

Enjoy

swagger