定义 OpenAPI 2.0 返回 JSON 未知类型的对象

Question

我想描述 returns JSON unknown/any 类型的对象的 OpenAPI。

如果我在下面的 yaml 中定义 return 类型，我仍然会看到生成的客户端 return 只是一个原始字符串。

responses:
  200:
    description: Returns any JSON object
    schema:
      type: string
      format: object

有没有办法将 return 类型描述为 JSON 对象而不描述其架构？

Answer 1

任意对象定义为type: object，所以正确的定义是：

responses:
  200:
    description: Returns any JSON object
    schema:
      type: object

Define OpenAPI 2.0 returning JSON object of unknown type