Swagger Web API documentation doesn't render HTML properly anymore

Vote count: 0

I've got Web service methods which return the same HTTP response for different reasons, such as a 400 Bad Request for different qualities of posted data. I use swagger to generate the API documentation.

Until recently, I used HTML to document responses to list different causes for the same HTTP response. Example:

...
/// <response code="400"><ul><li>New member model missing.</li>
/// <li>Account name missing.</li>
/// <li>Password missing.</li></ul></response>
/// <response code="409"><ul><li>Data consistency issue.</li></ul></response>
...

While this used to be fine, since a fairly recent Swagger update the HTML isn't rendered properly anymore and instead, I get the HTML elements rendered as text. Example result:

Listing the responses multiple times doesn't work. Has anyone a working solution for this?

asked 57 secs ago

Quality Catalyst

Let's block ads! (Why?)

Swagger Web API documentation doesn't render HTML properly anymore