JSON REST - идентификатор в URI или теле JSON

Question

Я изучаю REST API (в php), и у меня есть вопрос о том, где я должен поместить идентификатор для ресурса, который я хочу обновить.

Должен ли я поместить его в URI и патч для /users / 23 с телом:

{
    “name”: “John”
}

Или в теле JSON и патч для / users

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

Answer 1

Согласно Руководству по разработке API разработчика Google , API должны быть ориентированы на ресурсы.т.е. сам по себе путь API должен определять всю соответствующую информацию о пути ресурса.Следовательно, указание пути в самом URI является наилучшей практикой