Rest API设计：更新关系

Question

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

我应该如何建模可以更改PUT /user/institution PATCH /user注册的端点？

我的一些想法：

institution_id传递身体中的新机构_id。

users更新'a'

中的' '列

有什么建议吗？

Answer 1

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

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

使用PUT还会引导您在更新用户时提供整个模型，从而消耗网络流量。

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

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