在路径或正文中发布参数

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