PUT は、**更新** 機能に最もよく利用され、既知のリソース URI に PUT し、リクエスト ボディに元のリソースの新しく更新された表現を含めます。ただし、PUT は、リソース ID がサーバーではなくクライアントによって選択される場合にリソースを作成するためにも使用できます。言い換えると、PUT が存在しないリソース ID の値を含む URI に対して行われる場合です。繰り返しますが、リクエスト ボディにはリソース表現が含まれます。多くの人は、これが複雑でわかりにくいと感じています。したがって、この作成方法は、使用するとしても控えめにする必要があります。または、POST を使用して新しいリソースを作成し、ボディ表現にクライアント定義の ID を提供します。おそらく、リソースの ID を含まない URI に対してです (以下の POST を参照)。更新が成功すると、PUT から 200 (またはボディにコンテンツを返さない場合は 204) を返します。作成に PUT を使用する場合は、作成が成功すると HTTP ステータス 201 を返します。レスポンスの本文は、帯域幅を多く消費するのであればオプションです。作成の場合、クライアントがリソース ID を既に設定しているため、Location ヘッダーを介してリンクを返す必要はありません。PUT は、サーバー上の状態を変更 (または作成) する点で安全な操作ではありませんが、べき等性があります。つまり、PUT を使用してリソースを作成または更新し、同じ呼び出しを再度行うと、リソースはそのまま存在し、最初の呼び出しと同じ状態のままです。たとえば、リソースに対して PUT を呼び出すと、リソース内のカウンターが増加する場合、呼び出しはべき等性ではなくなります。このようなことが発生する場合があり、呼び出しがべき等性でないことを文書化するだけで十分な場合があります。ただし、PUT 要求はべき等性を保つことをお勧めします。べき等性のない要求には POST を使用することを強くお勧めします。例:
https://www.restapitutorial.com/lessons/httpmethods.html