rest - REST API - POST タイプのメソッドでパラメータを渡すための最良のオプションは何ですか?

Question

POST メソッドを使用してリソースを作成するための REST API を設計しています。この create 呼び出しは、必須ではあるが互いに論理的に関連していない 4 つのパラメーターを受け入れます。したがって、これらの 4 つの入力パラメーターを次のように受け入れるための 2 つのオプションがあります。

1. json オブジェクトとしてのリクエストの一部
   OR
2. (POST /api/someresource?param1=value1¶m2=value2) のようなクエリ パラメータの形式

どのオプションが最も適していますか?

事実に基づいて、上記の2つの方法のいずれかを選択することを提案するガイドラインはありますか?

1. これらは必須のパラメーターであるため、クエリパラメーターを使用しないでください。
2. これらは論理的に関連していませんが、リソースを作成するための単なる入力です。クエリパラメータを使用できますか？

Answer 1

/api/someresource?param1=value1&param2=value2GET要求であって、要求ではない可能性がありPOSTます。リクエストによってサーバーの状態が変わる場合は、 を使用してPOSTください。読み取り操作のみの場合は、 を使用しますGET。