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을 참조하십시오.