整数返回类型的Swagger数组

我刚刚开始使用swagger-editor来定义我的RESTful API,我对这些响应感到困惑.我的许多方法只返回一个整数数组,我不知道如何在YAML中指定它.

OpenAPI(fka Swagger)规范2.0使用JSON Schema v4的子集.您可以参考JSON Schema文档或本指南,了解如何使用JSON Schema描述不同的数据类型.但请记住,在OpenAPI/Swagger中,JSON Schema的某些功能不受支持或工作方式不同.规范提到了究竟支持的内容.

回到你的问题,一个整数数组定义为:

type: array
items:
  type: integer

paths:
  /something:
    get:
      responses:
        200:
          description: OK
          schema:
            type: array
            items:
              type: integer

paths:
  /something:
    get:
      responses:
        200:
          description: OK
          schema:
            $ref: "#/definitions/ArrayOfInt"

definitions:
  ArrayOfInt:
    type: array
    items:
      type: integer

definitions:
  ArrayOfInt:
    type: array
    items:
      type: integer
    example: [1, 2, 3, 4]
    # Make sure to put the multi-item "example"
    # on the same level as the "type" and "items" keywords