Swagger请求动态对象

Question

我正在使用 Swagger 作为我的 api 文档。有些Api使用动态post对象，所以我只使用：

parameters:
 - name: region
   in: body
   schema:
     type: object

在 swagger UI 中，我可以使用“编辑 Json”按钮编辑内容，但是单击“保存”后，没有任何内容附加到请求，当我单击“发送请求”按钮时，它仍然发送空请求。那么，我有什么错吗？

我在http://editor.swagger.io/上测试了这个，将post参数更改为“object”类型，然后仍然无法编辑json数据。

Answer 1

您可以使用additionalProperties它来定义具有动态属性的对象。例如：

parameters:
 - name: region
   in: body
   schema:
     type: object
     additionalProperties:
       type: object

这表示请求正文是一个没有固定属性的 JSON 对象。客户端可以在运行时指定任何类型的属性（字符串、布尔值、对象等）。有关 的更多信息，请参阅 OpenAPI 规范 v2.0 additionalProperties。