パスまたは本文にパラメータを投稿する

Question

Rest APIを作成していますが、URL構造がわかりません。 Postリクエストでサーバーにパラメータを1つだけ送信する必要があります。パス変数またはリクエスト本文で送信する必要がありますか？ベストプラクティスは何ですか？

現在のURLの例：

api/v1/users/{id}/name/{name}

nameは、状態を変更するためにサーバーに送信する変数です。

ありがとう

Answer 1

URLは通常、更新するリソースを識別します。

したがって、データはリクエスト本文の内部に入る必要があります

ユーザー名を更新するには、これをサーバーに送信します。

POST api/v1/users/{id} HTTP/1.1
Content-Type: application/x-www-form-urlencoded

name=string