在路径或正文中发布参数

Question

我正在创建 Rest API，但我对 URL 结构感到困惑。我必须在我的 Post 请求中向服务器发送一个参数。我应该通过路径变量还是在请求正文中发送它？最佳做法是什么？

当前网址示例：

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