同じエンドポイントで2つの異なるリクエストボディをサポートする

Question

同じエンドポイントと同じメソッド（POST）に対して2種類のリクエストボディをサポートする必要があります。スワッガーで可能ですか？

これは、両方のリクエスト本体が有効であり、ユーザーがどちらか一方を送信できるので重要です。具体的には、

RequestBody 1：

{ 
    param1: value1 
    param2: value2 
    param3: { 
     param3Key1: x1 
     param3Key2: x2 
     ... 
    } 
} 

RequestBody 2：

{ 
    param1: value1 
    param2: value2 
    param4: { 
     differentKey1: y1 
     differentKey2: y2 
     ... 
    } 
} 

が闊歩で、この状況を文書化する方法はありますか？

これを行う1つの方法は、param3とparam4の両方をドキュメントに保存することです。しかし、私はユーザーに、そのうちの1つだけが渡される必要があることを明確に知りたがっています。私は、両方の状況に対してまったく異なるリクエストボディを持ちたいと思っています。

Answer 1

ストレートウェイが見つかりませんでした。ここに私が今追いかけている回避策があります：

終点が/endpointであるとします。

/endpoint#1

/endpoint#2

私は、これらのエンドポイントのそれぞれの下で個別に私の要求-体の両方を定義することができます：私は、文字列が続く#を追加することで威張っ-UIの2つのエンドポイントを作成することができます。スワッガーのcurlコマンドはハッシュを隠すので、両方のエンドポイントは基本的に同じです。