どのように2つのオブジェクトを含む良いRESTFul Web APIを設計するのですか？

Question

2つ以上のオブジェクトを含む良いRESTFul APIを設計する方法を知りたいとします。たとえば、書籍の情報を取得したり、/book/1や/anthor/1などのanthorの情報を取得するためのAPIを設計するのは簡単ですすべての本をアンソースにするにはどうしたらよいですか？
1. author/{author_id}/books
2. books/get_by_author?author_id=1
3. books/search?author_id=1
より良いものです ？ありがとう〜

Answer 1

まあ、それは本当にあなたのユースケースに依存します。 あなたが制限された検索条件で帳簿上の検索機能を提供しようとしている場合、私はあなたの検索条件は、将来的に成長するならば、私はそうのようなPOSTのAPIをお勧めします

GET books?author_id=1&genre=fiction 

のようなものとなるだろう

POST books/search 
{ 
    "author_id": 1, 
    "genre": "fiction", 
    "year": 2012 
} 

しかし、あなたは常に特定の作者のために「のみ」本を試してみて、フェッチするつもりなら、

authors/<author_id>/books 

で行きます

Answer 2

オプション1は良いオプションです。著者の代わりに著者を使用する。あなたのURLは次のようになります。

/著者S/{AUTHOR_ID} /ブック