スワッガークエリの有効なパラメータ定義はありませんか？

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}: 

パラメータで定義されたクエリのみが必要です。さもなければ全部をバグしてください。