基本パスは同じだが要求構造は異なる2 apisのスガーガースペックを定義するにはどうすればよいですか？

Question

例：

これは最初の定義である：

/** 
* @swagger 
* /a/b/items: 
* get: 
*  description: Get all the items 
*  responses: 
*  200: 
*   Returns an array of items 
*/ 

これが第二の定義です：

/** 
* @swagger 
* /a/b/items: 
* get: 
*  description: Get items by ids 
*  parameters: 
*  - name: ids 
*  in: query 
*  required: true 
*  schema: 
*   $ref: '#/definitions/itemIds' 
* 
*  responses: 
*  200: 
*   description: Returns an array of items, given the itemIds 
*/ 

ここでの違いは、リクエスト構造体である、ことは明らかです。 2番目の定義では、クエリでパラメータIDを渡したいと思います。

最初の定義は、任意のパスパラメータやクエリパラメータなしのシンプルなGETリクエストです。

2番目の定義は、同じベース・パスではなく、クエリのparamsとget要求です。私は連続してこれら二つを定義するとき

、2番目の定義は、以上の最初の1を書き込み、闊歩UIは二番目を示しています。

それはユニークなものとして、これら二つの定義を持つことが非常に望ましいです。一意性を達成するために

どれソリューション/思考/方法？

ドキュメントをサポートするようにapisを変更するだけでいいですか？

ご協力いただければ幸いです。 ありがとうございます！

Answer 1

私は第二の定義内のエンドポイントに変更する必要が信じている：最初の定義を削除し、必要に応じて第二の定義を持つ

/a/b/items/{ids}: