ruby-on-rails - 安らかなURLのベストプラクティスは何ですか？

Question

私はJavaベースのRESTサーバーを持っており、クライアントは主にRubyを使用します。

URL構造のベストプラクティスと考えられるものは何ですか？

これはJSON専用です。

これがブログアプリケーションだとしましょう：

例えば：

すべての投稿を取得する：

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

ID1の投稿を削除します。

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

次のような埋め込みコレクションについてはどうですか？

投稿1のすべてのコメントを取得します。

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

ID1の投稿1のコメントを表示します。

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

これをどこかに超える文書はありますか？かなり「公式」なものですか？

score 0 · Accepted Answer

RESTを作成した論文から始めて、URIセクションを見ることができます： http ：//www.ics.uci.edu/~fielding/pubs/dissertation/evaluation.htm#sec_6_2

このSOの質問に対するBobAmanの評判の良い2番目の回答は、詳細なガイダンスを提供します。動詞なしでREST URLを作成する方法は？

score 0 · Accepted Answer

HTTP プロトコルを正しく使用することが最善の方法です。URL のバージョン管理について読んでください。http://blog.steveklabnik.com/posts/2011-07-03-nobody-understands-rest-or-http

score 0 · Accepted Answer

Apigee には、RESTful API 設計に関する無料の電子書籍があります。それを取得するには、電子メールアドレスを指定する必要があります。

これは意見の問題であり、公式の仕様はありませんが、あなたの URL は私には適切に見え、その本のガイドラインに従っています。可能な例外は最後です。1 がコメントの一意の ID である場合、/posts/1/ は必要ない場合があります。

3 に答える 3