Atom Publishing Protocol (RFC5023) を Swagger / OpenAPI 仕様に変換して、それらの仕様を作成しようとしています。
次の問題に遭遇しました。Atom には、コレクション URI とメンバー URI など、さまざまなタイプの URI があります。私の考えは、次のように文書化することでした:
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"
私がそれを行うと、swagger-editor は次のように主張します。
同等のパスが既に存在します: /{MemberURI}
これらは、照会時に異なるものを返すさまざまなタイプの URI です。それらを個別に文書化するために、それらを別の方法で呼びたいと思います。
これを行う方法はありますか?
ありがとう!
編集:仕様は Swagger-UI で問題なく表示されます-これはエディターのバグですか、それとも UI は私のエラーを無視しますか?