php - RESTfulAPIパス設計ガイドライン

Question

安らかなAPIが欲しいのですが、次のうちどれがより実用的でしょうか？

1. myapi.com/users/ {userid}
2. myapi.com/users?userid={userid}

URLパラメータとパスのパラメータをいつ渡す必要があるのか​​混乱しています。

Answer 1

パラメータは、クエリのフィルタリングに使用されます。

http://www.acme.com/products/?filter=cats&sort=des

そして、パスは要素を取得するために使用されます。

http://www.acme.com/products/1234

したがって、を使用することをお勧めしますmyapi.com/users/{userid}。

このすばらしいプレゼンテーションからスライド60にジャンプします（読むことをお勧めします）。