使用Swashbuckle.AspNetCore,如何为FromBody参数提供表单?



在我的WebAPI中,我有一个更改密码的方法。它采用一个参数,该参数是一个包含两个属性的类:"OldPassword"和"NewPassword"。 显然,我不想通过查询字符串传递它,我希望将 em 传递到正文中。 一旦我使用 FromBody 属性,Swagger UI 就不再提供带有两个文本框的漂亮表单,它会变成单个 JSON blob。

我想混合这些行为,提供一个表单,但将输入格式化为与架构匹配的 json。

我尝试使用OperationFilters,但无法实现类似的东西。 我敢肯定这很常见,但我的谷歌和堆栈溢出搜索没有返回任何内容。也许我没有在寻找正确的关键字。拿不准。

决定在正文中坚持使用 json blob,因为这是最有意义的决定,设计明智。

我用 FromHead 得到了它,但考虑到这不是这个 API 应该被使用的方式,我们更愿意坚持针对实际用例进行设计,而不是围绕 Swagger 的功能和限制。

感谢您的回答!

最新更新