python - 我应该如何创建良好的休息 api？

Question

获取用户的帖子：GET http://test.com/users/123/posts或 GET http://test.com/posts?user_id=123

获取新帖子计数：GET http://test.com/posts/count/new或http://test.com/new_posts_count或其他？

Answer 1

这是一本好书：http: //www.vinaysahni.com/best-practices-for-a-pragmatic-restful-api。

就您建议的两种格式而言：我更喜欢前者。

Answer 2

从 REST 的角度来看没关系（REST 没有定义 URI 结构）。客户端不应该事先知道 URL 结构，因此从技术上讲，它对客户端也无关紧要。

我个人更喜欢第一种风格，因为我认为当你有资源层次结构时它更有意义。它还允许客户端通过简单地切断最终资源来向后移动 URI，类似于通过简单地单击父按钮来备份文件系统上的目录的方式。

但从 REST 的角度来看，对此没有“正确答案”。REST 关注资源状态的传输，而不是资源层次结构或 URI 定义。