Rest Api Создать дизайн ресурса

Question

У меня есть служба отдыха и на этом я хочу добавить атрибут для каждого объекта, который у меня есть. Итак, у меня есть игровые объекты, и я хочу добавить статистику своей игры после каждой игры.

Мой конечный пункт, чтобы получить всех игроков;

GET /api/players 

и у меня есть игровой объект, в котором есть идентификатор игрока; так хорошо, если я разрабатываю сервис без указания идентификатора игрока на ссылке, поскольку объект уже имеет его;

POST /api/players/game [gameObject] 

или я должен поместить идентификатор в ссылке, а

POST /api/player/{playerID}/game [gameObject] 

Answer 1

Оба они прекрасно. Речь идет о том, насколько вы можете описать свои URL-адреса.

Лично я предпочел бы второй URL-адрес, потому что его легче понять, и в первом случае понятно, что game object предназначен для конкретного игрока.

READ: Best Practices for Designing a Pragmatic RESTful API