宁静的网址的最佳做法是什么？

Question

我有一个基于java的休息服务器，我的客户将主要使用Ruby。

什么被认为是URL结构的最佳实践？

这仅适用于JSON。

之所以这样说，是博客应用程序：

如：

获取的所有帖子：

GET http://www.example.com/api/v1/posts.json 

删除帖子ID为1：

DELETE http://www.example.com/api/v1/posts/1.json 

什么嵌入式收藏喜欢：

获取所有评论为岗位1：

GET http://www.example.com/api/v1/posts/1/comments.json 

查看职位1的评论ID为1：

GET http://www.example.com/api/v1/posts/1/comments/1.json 

有去在这个地方的文件？相当“官方”的东西？

Answer 1

Apigee有一个关于RESTful API设计的免费电子书。你必须提供一个电子邮件地址，以获得它：

http://offers.apigee.com/api-design-ebook-rr/

你会发现这是见仁见智的，没有正式的规范，但你的URL看起来对我好，并会在根据该书中的指导原则。可能的例外是最后一个。如果1是评论的唯一ID，那么/ posts/1 /可能不是必需的。

Answer 2

你可以与创造REST纸开始，并期待在URI部分： http://www.ics.uci.edu/~fielding/pubs/dissertation/evaluation.htm#sec_6_2

鲍勃·阿曼的广泛关注的第二个答案，这太问题给出了详细的指导： How to create REST URLs without verbs?

Answer 3

正确使用HTTP协议是最好的主意。阅读一些关于url版本的信息。 http://blog.steveklabnik.com/posts/2011-07-03-nobody-understands-rest-or-http