我有Web服务方法,由于不同的原因返回相同的HTTP响应,例如对不同质量的发布数据的400 Bad Request . 我使用Swashbuckle生成Swagger API文档 .
直到最近,我使用HTML元素来记录响应,以列出相同HTTP响应的不同原因 . 例:
...
/// <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>
...
虽然这曾经工作得很好,但是由于Swashbuckle的最新更新,HTML不再正确呈现,而是将HTML元素呈现为文本 . 示例结果:
多次列出响应不起作用 . 有没有人为此工作的解决方案?
1 回答
如果它曾经工作但不再工作,那可能是Swashbuckle的一个问题 . 尝试使用比您正在使用的版本更旧的软件包版本 .
有关所有版本(公开)的列表,请参阅Swashbuckle on NuGet .
如果您发现最新版本确实破坏了此功能,请向开发人员提出问题 . 列出问题的正确位置是在Github上:
domaindrivendev/Swashbuckle.AspNetCore for ASP.NET Core . 主要版本6或更高版本 .
domaindrivendev/Swashbuckle for ASP.NET 4.x.主要版本5或更低版本 .