2017-07-05 6 views
0

サーバレスポンスにリソースのIDが含まれていれば、残りのAPIの良いプラクティスまたは標準とは何ですか?残りのAPIの応答にはリソースのIDが含まれていますか?

たとえば、この応答は、リソース

GET /users/5 
{ 
"user_id": 5 
"first_name" : "John", 
"last_name" : "Doe", 
"minutes_active": 10 
} 

のIDが含まれており、これは、リソースのIDが一つがこのことを前提とし

GET /users/5 
{ 
"first_name" : "John", 
"last_name" : "Doe", 
"minutes_active": 10 
} 
+0

クライアントが何かを行うためにIDを必要とする場合(たとえば、コマンドに含める場合など)、そうでない場合は含めます。 RESTFUL APIが必要な場合、クライアントはサーバーからのリンクを受信し、クライアントはそれを単独で構築しません。 –

答えて

2

要求のURLに記載されていることを前提とリソースのIDは、リクエストのURLに記載されているIDです。

Fromクライアントの観点、URIは不透明です。解析すると予想されるURIに情報を入れてクライアントに情報を伝えている場合、プロットは失われてしまいます。

APIでクライアントがIDを利用できるようにする必要がある場合は、そのIDをリソースの表現に含める必要があります。

「URIは不透明ですが、解析する予定のURIに情報を入れてクライアントと情報をやりとりしている場合...」とはどういう意味ですか?クライアントがURIを作成したように見えるので、表面上はIDをすでに知っています...?

一般的に、REST APIクライアントはURIを構築するのではなく、リンクに従います。 HTTPリクエストには、クライアントが特定のURIを選択する方法(何がブックマークか他の表現のリンクか、フォームの記入結果など)を示すものは何もありません。

+1

「URIは不透明ですが、解析する予定のURIに情報を入れてクライアントと情報をやり取りしている場合...」とはどういう意味ですか?クライアントがURIを作成したように見えるので、表面上はIDをすでに知っています...? –

関連する問題