swagger中包含不同对象类型数组的模型响应

Question

我想在swagger中建模一个包含一组不同类型对象的响应对象，如下所示:

{
   "table": [
        {
          "user" : []
        },
        {
          "customer": []
        },
        {
           "employee": []
        }
    ]
}

我尝试了下面的解决方案，但它将所有属性包装在一个对象中 { [ { "用户": [], "客户": [] } ] }.

  responses:
    200:
      schema:
        type: array
        items:
          type: object
          properties:
            user:
              type: array
              items:
                $ref: '#/definitions/User'
            customer:
              type: array
              items:
                $ref: '#/definitions/Customer'
            employee:
              type: array
              items:
                $ref: '#/definitions/Employee' 

Answer 1

这将在OpenAPI spec (3.0)的下一个版本中得到支持，下面是关于该特性的相关讨论:

https://github.com/OAI/OpenAPI-Specification/issues/57

这是一个示例（在上面的URL中提供）：

{
  "oneOf": [
    { "$ref": "Cat" },
    { "$ref": "Dog" }
  ]
}