JSON REST-URI或JSON正文中的ID

Question

我正在学习REST api（使用php），并且有一个问题，我应该将要更新的资源的ID放在哪里。

我是否将其放在URI中并使用以下内容修补到/ users / 23：

{
    “name”: “John”
}

或者在JSON正文中并修补到/ users

{
    “id”: 23,
    “name”: “John”
}

Answer 1

根据Google Developer API design guidelines，API应该面向资源。即API路径本身应定义有关资源路径的所有相关信息。因此，将路径放入URI本身是最佳做法