更正相关对象的 REST API URL 格式

Question

我正在设计一个 REST API，其中有两个对象。

• Journey
• Report

对于每个Journey，有许多Reports 航路，每个Report 恰好有一个关联的Journey。

用户可以使用 API 创建Journey，如下所示...

POST /journey/

然后检索详细信息...

GET /journey/1226/

第一个问题是，如果用户想将Report 发布到他们的Journey，那么API 应该施加的“正确”URL 结构是什么？这对我来说似乎很直观......

POST /journey/1226/report/

...或者是这种情况...

POST /report/

...在后者中，Journey ID 在请求正文中的某处传递？

第二个问题是，如何在 Django REST 框架等工具中实现第一个案例？

谢谢！

Answer 1

URL/URI 结构几乎完全不相关。很高兴能够阅读它，或者轻松更改甚至猜测它，但仅此而已。没有官方或不成文的“要求”它们应该是什么样子。

然而，重点是您在响应中提供 URI 给您的客户。每个 GET 都会为您提供一个表示，其中包含指向您的客户可以到达的下一个“状态”的链接。这意味着服务器可以完全控制 URI 结构，客户端通常只需要知道“开始”或“主页”URI，仅此而已。

这是一篇讨论这个问题的文章，有一些好处：http://www.ben-morris.com/hackable-uris-may-look-nice-but-they-dont-have-much-to-do-with-rest-and-hateoas/

第二个问题通过 :) 我没有使用那个特定的框架。