Swagger：異なるパラメータにもかかわらず "同等のパスはすでに存在しています"

Question

私はAtom Publishing Protocol（RFC5023）をSwagger/OpenAPI仕様に変更しようとしています。

私は次の問題に遭遇しました：Atomには、さまざまなタイプのURIがあります。コレクションURIとメンバーURI。 私の考えは、このようにそれを文書化することでした：/ {MemberURI}

ものは以下のとおりです。私は威張っ-エディタが

同等のパスが既に存在していることを主張し、それを行うとき

paths: 
    /{CollectionURI}: 
    get: 
     summary: List Collection Members 
     ... 
    post: 
     summary: Create a Resource 
     ... 
    parameters: 
     - $ref: "#/parameters/CollectionURI" 
    /{MemberURI}: 
    get: 
     summary: Retrieve a Resource 
     ... 
    parameters: 
     - $ref: "#/parameters/MemberURI" 

照会されたときに異なるものを返す異なるタイプのURI。私はそれらを個別に文書化するためにそれらを別々に呼びたいと思う。

これを行う方法はありますか？

ありがとうございます！

EDIT： 仕様はSwagger-UIでうまく表示されます。これはエディタのバグですか、UIは私のエラーを無視していますか？

Answer 1

これは、2つのパスが同一である可能性があるからです。私はパラメータがそれらを一意に識別できるかもしれないと理解しますが、Swagger 2.0は完全なURIテンプレートをサポートしておらず、パス部分だけが一意性について検査されます。したがって、次のようになります。

/{foo} 
/{bar} 

fooは文字列でなければならず、barは数字でなければなりません。現在、より良い経路サポートに取り組んでいるため、OpenAPI Specification Repoに0.02ドルを追加してください。