Swaggerのダッシュでパスパラメータを区切る方法

Question

既存のAPIにYamlを使用してSwaggerドキュメントを作成しようとしています。 は、このAPIでは、このようなパスがあります：

/api/foo--bar/baz 

だから私はこのような闊歩エディタでパス定義作成：

paths: 
    /api/{foo}--{bar}/{baz}: 
    get: 
     parameters: 
     - $ref: '#/parameters/foo' 
     - $ref: '#/parameters/bar' 
     - $ref: '#/parameters/baz' 
[...] 

今私は私に言って、エディタにこだわっています：

を

パスのセマンティクスエラー/api/{foo}-- {bars}/{baz} 部分パステンプレートは許可されていません。

上記のようなURLパスをスワッガーで表現する可能性はありますか？

Answer 1

構文が正しいです。 が表示されるエラーは、Swagger Editor 3.0-3.1.5では です。このエラーを無視するか、このバグのないhttp://editor2.swagger.ioの古いSwagger Editor 2.xを使用してください。

更新：この不具合は、Swagger Editor 3.1.6およびオンラインエディタhttp://editor.swagger.ioで修正されました。