如何在Swagger UI的multipart / form-data中的json参数中显示架构？

Question

我正在使用OpenApi 3.0和Swagger UI。

（（重要的是Swashbuckle和ASP.Net Core）

我有multipart/form-data，它具有2个参数：

• [ProductToAdd JSON中的对象描述
• Image作为文件。

我已经定义了模式和示例。

目前，我设法做到了

而且我的目标是这样的：

我的问题是如何像第二张图片一样呈现架构和示例？我在swagger.json中没有发现任何帮助，等等。

Ps。如果您有好奇心，可以完美地执行工作。

@ edit

我为此制作了nuget包。您可以找到它here

Answer 1

当前（截至2019年9月），Swagger UI不在multipart/*请求中显示对象类型字段的架构，它仅显示这些字段的示例值。这是相应的功能请求：

Display static documentation information for multipart properties in OpenAPI 3.0 files