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 对象。客户端可以在运行时指定任何类型的属性(字符串、 bool 值、对象等)。有关 additionalProperties 的更多信息，请参阅 OpenAPI 规范 v2.0。