Swagger 쿼리에 유효한 매개 변수 정의가 아닙니까?

Question

# GET verb version of the "GetClientsForGadget" method from the original ASMX Service 
    /clients/ProspectClient/roleandcstbased/{OrgNmFilter}/{SortNm}?{UserName}: 
    get: 
     tags: 
     - Client 
     summary: Merging of GetClientsforGadget and GetClientsForUser 
     operationId: ClientsForGadgetGET 
     parameters: 
     - name: OrgNmFilter 
      in: path 
      description: Organization Name Filter 
      required: true 
      type: string 
     - name: SortNm 
      in: path 
      description: Sort Field 
      required: true 
      type: string 
     - name: UserName 
      in: query 
      description: User's Identity 
      required: false 
      type: string 
     responses: 
     200: 
      description: Output results for GetClientsForGadget endpoint 
      schema: 
      $ref: '#/definitions/ClientOutput' 

Swagger가이 쿼리 매개 변수에 유효한 매개 변수 정의를 제공하지 않습니다. 경로 및 매개 변수 정의에서 Username에 대한 모든 참조를 제거하면 문제가 없습니다.

Swagger Specification에 따르면, 저는 쿼리 매개 변수를 올바르게 사용하고 있다고 생각합니다.하지만 어떻게 든 그렇지 않습니다.

Answer 1

실현 경로에 문제가 있습니다. 경로에는 쿼리 매개 변수가 포함될 필요가 없습니다.

/clients/ProspectClient/roleandcstbased/{OrgNmFilter}/{SortNm}?{UserName}: 

/clients/ProspectClient/roleandcstbased/{OrgNmFilter}/{SortNm}: 

매개 변수로 쿼리를 정의하면됩니다. 그렇지 않으면 모든 것을 버그 야.