Rest Apiベストプラクティス - クエリパラメタとして日付を渡す

Question

私はNodeJsとExpressミドルウェアを使用して休憩サービスを作成しています。

1. 私はすなわちGET、POST、PUTとDELETE方法の種類に関係なく、すべてのサービスでユーザーIDを取得し、認証用トークンする必要があります - 私が質問の下に持っています。これらの2つのパラメータ、つまりリクエストヘッダーまたはクエリパラメータを取る最良の方法は何ですか？私は身体のパラメータとして取得することを望んでいないので、取得要求は体を持っていないでしょう。

2. データ取得のためにメソッドタイプGETを使用してサービスを書きたいとします。この呼び出しのパラメータは文字列と日付です。どのようにshoule私はこれのためのクエリパラメータとして、具体的に日付のparam私はjsの日付または他の任意の形式としてそれを渡す必要がパラメータを渡す？

   GET - https://localhost:someport/<objectid>/<createddate> 
   headers - x-user-id:someid 
         x-access-token:sometoken 
   

   この場合、作成された日付を渡す必要があります。

   または以下のものを使用する必要がありますか？

   GET - https://localhost:someport/ 
   headers - x-user-id:someid 
         x-access-token:sometoken 
         x-object-id:someid 
         x-created-date:somedate 
   

Answer 1

リクエストヘッダーは、そのような機密情報を送信するのに最適な場所です。ヘッダーは、http要求のすべてのメソッドで共通です。そのため、あなたはGET、POST、PUTのような方法について心配したくありません。クエリパラメータを使用すると、URLでより醜いものになります。
さらに、私はUserIDとtokenの使用法については知らない。安らかなサーバーでは、ユーザーを識別するためにトークンを使用するためです。そのため一般的にユーザーIDは送信しません。

Answer 2

残りのAPI設計のベストプラクティスは、そのクエリのparamsとして要求を取得するためにユーザーの機密情報ではないパラメータを公開言います。だから、ユーザーIDと物事のようなものはヘッダーに入れなければならず、他のものは要求パラメーターを取得することができます。

ヘッダーにユーザーIDとトークンのみを持つ最初のものを選択します。