Rest API 设计：更新关系 [关闭]

Question

我正在尝试为 API 寻找最佳设计。我有 user 和 institution 对象。每个user 只能有一个institution，它在users 表中由institution_id 列表示。

我应该如何对一个端点进行建模，该端点会更改 institution 和 user 注册的对象？

我的一些想法：

PUT /user/institution 在正文中传入新的机构 ID。

PATCH /user 更新users 中的institution_id 列

有什么建议吗？

Answer 1

我相信PATCH /user updating the institution_id column in users

更好，因为您正在更新用户模型中的属性，并且您可以将其视为属于用户的任何其他属性，例如电子邮件、地址等，因为机构 ID 是用户表中的列。

同时使用 PUT 会导致您在更新用户时提供整个模型，这会消耗您的网络流量。

顺便说一句，使用 PATCH 时，您只提供要更新的属性，而使用 PUT 时，您提供整个用户模型。

2 个动词（PUT AND PATCH）的返回数据应该是整个模型，而不仅仅是更新的属性。