寧靜的網址的最佳做法是什麼？

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