8

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 は私のエラーを無視しますか?

4

1 に答える 1