従業員データを提供するための安らかなサービスを構築しています。
クライアントの特定の部門に属する従業員のリストを返すAPIがあります。
このAPIは、clientIdとdepartmentIdの2つのパラメーターを取ります。
標準に従って、このAPIのRESTful URLを作成する正しい方法は次のうちどれですか？
1）/ client / {clientId} / department / {departmentId} / employee
2）/ client / {clientId} / employees？departmentId = {departmentId}
Restful URLは複数のパスパラメータを持つことができますか？上記の質問に「はい/いいえ」の場合-なぜそうなのですか？
RESTful APIでは、パスパラメーターを使用してリソース（クライアント、注文、ブログ投稿など）を識別します。このリソースは、多くの場合、一部のデータベースのレコードです。一部のデータベーステーブルには複合キーがあります。たとえば、複数の異なるクライアントの従業員に関するデータを格納するシステムがある場合、データベースに次のようなエントリがある可能性があります。
name | client_id | department_id
John | 1 | 1
Jane | 2 | 1
両方のクライアントにIDの部門がある場合1。
その場合、特定のクライアントの特定の部門のすべての従業員のリストのリソースを識別することが目的である場合は、いくつかのパスパラメータを使用するのが理にかなっています。
/client/{clientId}/department/{departmentId}/employees
ただし、これが検索APIである場合は、
employees?age={age}&height={height}
この記事はインターネットから収集されたものであり、転載の際にはソースを示してください。
侵害の場合は、連絡してください[email protected]
コメントを追加