如何在 Swagger UI 的 multipart/form-data 中的 json 参数中显示模式？答案

【问题标题】：How to show schema in json paramater in multipart/form-data in Swagger UI?如何在 Swagger UI 的 multipart/form-data 中的 json 参数中显示模式？
【发布时间】：2019-09-25 11:43:27
【问题描述】：

我正在使用 OpenApi 3.0 和 Swagger UI。

（如果重要的话，Swashbuckle 和 ASP.Net Core）

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

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

我定义了模式和示例。

现在我设法做到了

我的目标是这样的：

我的问题是如何呈现第二张图片中的模式和示例？我在 swagger.json 等中没有发现任何有用的东西。

附言。如果您有好奇心，请完美执行工作。

@编辑

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

【问题讨论】：

标签： asp.net-core swagger swagger-ui swashbuckle

【解决方案1】：

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

Display static documentation information for multipart properties in OpenAPI 3.0 files

【讨论】：

哦……好伤心