swagger - 如何在 Swagger 2.0 中引用顶级参数

Question

我试图弄清楚如何使用顶级参数，然后在操作级别使用 $ref 来引用在顶级对象中声明的定义。

这是 YAML 的样子，但是当我尝试这个时，我得到一个显示的空参数。任何人都知道正确的语法吗？

swagger: '2.0'
info:
  version: 0.1.0
  title: Customer API
parameters:
  index:
    name: index
    in: query
    description: Specifies the offset of the first item to be returned. The default value is 0, which starts at the beginning.
    type: integer
    default: 0
    minimum: 0
paths:
  /customers:
    get:
      parameters:
        - $ref: '#/parameters/index'
      responses:
        200:
          description:  List all customers
          schema:
            $ref: '#/definitions/Customers'
definitions:
  Customer:
    properties:
      name:
        type: string
      id:
        type: integer
        format: int32
  Customers:
    properties:
      startIndex:
        type: integer
      itemsPerPage:
        type: integer
      totalResults:
        type: integer
      entries:
        type: array
        $ref: Customer

Answer 1

对此的支持尚未在 swagger-ui 中实现。请参阅https://github.com/swagger-api/swagger-ui/issues/621。