我该如何创造良好的休息api？

Question

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

获取新帖子数量： 获取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定义。