如何在 Swagger 规范中接收动态响应

Question

我想通过 API 从我的数据库请求一个 table。但是，我不知道 table 会有多少列，或者它会包含什么。我如何在 Swagger 中指定它？这就是我想要做的：

paths:
  /reports/{id}:
    get:
      summary: Detailed results
      description: filler
      parameters:
        - name: id
          in: path
          description: filler
          required: true
          type: integer
          format: int64
      responses:
        200:
          description: OK
          schema:
            type: array
            items: 
              $ref: '#/definitions/DynamicObject'
definitions:
  DynamicObject:
    type: object
    properties:
      **$IDONTKNOWWHATTODO**

关于如何定义没有特定参数的 JSON 对象有什么想法吗？

Answer 1

描述任意JSON，请使用"type": "object"。这是 JSON 中的示例：

    "responses": {
      "200": {
        "description": "successful operation",
        "schema": {
          "type": "object"
        }
      }
    },

如何在 Swagger 规范中接收动态响应

How to receive a dynamic response in a Swagger spec

swagger

swagger-2.0

openapi