java - 为什么在更新资源时在 URI 中有一个 id 参数？

Question

我正在创建一个 API，我想知道为什么在 PUT 的 URI 中有一个 id 参数很常见？

例如PUT/cars/5为什么没有 PUT/cars？请求实体包含一个 id 字段还不够吗？我可以从该实体获取 ID，或者这是否有一些缺点，这样做是否被认为是不好的？

Answer 1

因为如果你要发送 PUT请求 /cars ，从语义上讲，这意味着您正在尝试修改有关一组汽车的属性，而不是修改单个汽车的属性。 RESTful API 中的 URI 应指示操作所作用的确切资源，因此如果您要修改资源，您的 URI 应准确指示该资源。

此外，来自 RFC 2616 :

The URI in a PUT request identifies the entity enclosed with the request -- the user agent knows what URI is intended and the server MUST NOT attempt to apply the request to some other resource.

因此规范表明，如果客户端知道资源的唯一 ID，则应将其包含在 URI 中。