スワッガーは、パスパラメーターで始まる呼び出しを表示しません

Question

最初にパスパラメーターを持つパスへのルートを持つときに、swagger-ui経由でスガーガにアクセスすると、このメソッドは表示されませんでした。

例：

[Route("/{Version}/userdata", "GET")] 
public class UserData 
{ 
//... 
} 

私も正しくswagger-uiに表示され/v1/getSomeDataと/v2/getSomeOtherDataのようなパスを使用しています。しかし、パスの始めにパス変数を使ってアクセスするさまざまなバージョン（v1/v2）を持つことができるいくつかのメソッドもあるはずです。

これは可能ですか？もちろん私はまた、各バージョン等

Answer 1

闊歩2.0 specification定義は以下のようになります。

ただし、サービススタックスワッガーの生成toolingはスワッガー1.2 specのみをサポートしています。 Service Stackのテクニカルリーダーである@mythzによると、あなたがしたいことは、既存のツールを使用してサポートされていないことです。これが事実である、とあなたは間違いなくあなたのサービスのために闊歩定義が必要な場合は

、あなたはのいずれかの操作を行いますすることができます：ツーリングサポート

が作成し

1. 変更何かにあなたのエンドポイントのルートをご既存のように闊歩定義を手動で
があなたの状況では、あなたのツーリング

を変更

、私が行うための最善のことは、エンドポイントのルートを変更することだと思いますツーリングは定義を生成することができます。これは、パスパラメータを削除することを意味します。

これを行うことができない場合は、手動でswagger 2.0定義を作成します。これに助けが必要なら私に知らせてください。

Answer 2

闊歩UIグループ異なる応答を有し、リテラルパスする必要があるルート/経路下でそのルートを表示するので/{Version}/userdataための2つの方法を表示する必要があります。

{ 
    "paths":{ 
     "/{Version}/userdata":{ 
      "get":{ 
       "produces":[ 
        "application/json", 
        "text/json" 
       ], 
       "parameters":[ 
        { 
         "name":"Version", 
         "in":"path", 
         "required":true, 
         "type":"string" 
        } 
       ], 
       "responses":{ 
        "200":{ 
         "description":"OK" 
        }, 
        etc... 
       } 
      } 
     } 
    } 
} 

だから闊歩仕様を使用してエンドポイント/{Version}/userdataの定義についての本質的に不可能は何もありません：あなたのエンドポイントの