Swagger请求动态对象

Question

我正在使用Swagger作为我的api doc。有些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对象。客户端可以在运行时指定任何类型的属性（字符串，布尔值，对象等）。有关additionalProperties的更多信息，请参阅OpenAPI规范v2.0。