RESTful Webサービススキーマを開発するための優れたリソースは何ですか？

Question

私は、アプリケーション用の新しいREST WS APIを構築することを検討しています。私は技術的な面で宿題をして、パス/リソース/リソースの設定についてかなり自信を持っています。しかし、これらの道筋がどのようなものであるべきかを開発するためのプロセスのために、良い人材の提案はありますか？そこにはどのような方法があるべきか、それ自体の資源はどうあるべきかなど。

最終的にこれは開発者としては最終的には私に任せていますが、「私はしばらくの間、自分のドッグフードを完璧にまで食べることができます"

私は、この種のAPI設計方法論はRESTに排他的ではないと思うが、今は私が現在取り組んでいる文脈であると思われる。 :)

Answer 1

サービスの消費者の立場から考えてみるのがよいと思います。 APIデザインに関する本をお勧めしたいと思います。 Here's a starting point。

Answer 2

REST APIのよくある誤解について、RESTを作成した人がthis articleを読んでください。特に、APIの一部としてアウトオブバンドのURI規約を定義することを避ける必要があります。ネストされた/ URIs/to/resourcesはRESTとは何の関係もなく、APIの一部としてエントリポイントURI以上のものを提供する場合、その制約の1つにも違反します。