Postman でテストします

If you are new to the process required to obtain OAuth 2.0 Token Credentials for making requests to a HERE service or merely wish to verify your access keys, it may be helpful to use a tool like Postman. The following is an example of utilizing the access keys you obtained when you got your credentials on either the HERE platform or here-tech.skawa.fun. This includes generating correctly signed bearer access tokens and making a test request to a HERE service.

1. Postman を入手してインストールします。

   注

   この例では、 Microsoft Windows 用の Postman v7.12.0 が使用されています。

2. Postman を起動し、 HERE API OAuth 2.0 トークンエンドポイントに新しいリクエストを作成して保存します。
   
   
   
   
   
3. HTTP メソッドを「 POST 」に変更し、 HERE トークンエンドポイント ( 通常は https://account.api.here.com/oauth2/token ) を入力します。

4. リクエストの [ 承認 ] タブを選択し、 Developer ポータルで取得したアクセスキーの値を
   次のように入力します。 a. シグニチャタイプとして「 OAuth 1.0 」を選択します。 このバージョンは署名に使用されます。 他のすべての関数は OAuth2.0 バージョンを使用します。
   

   注

   HERE は、セキュリティを強化するために、 OAuth 2.0 アクセスベアラートークンに署名します。

   
   b. 「リクエストヘッダ」に承認データを追加するオプションが選択されていることを確認
   
   してください。 c. 「 Consumer Key 」フィールドに、 HERE .ACCESS.KEY.id の値を入力
   
   します。 d. 「 Consumer Secret 」フィールドに、 here.access.key.secret の値を入力します。 このアクセスキー ID は、資格情報を作成したときにダウンロードしたファイルから取得されます
   
   「詳細」セクションで、 HMAC-SHA256 が選択されている署名方式であることを確認してください。
   

5. リクエストの [ 本文 ] タブを選択
   します ラジオボタン [x-www-form-urlencoded] を選択
   します 値「 client_credentials 」を使用して、新しいキー「 grant_type 」を定義します。
6. リクエストを「送信」
   します 要求が正常に送信された場合、アクセスベアラートークンの値が response.b に表示されます
   このトークンを使用して、 86399 秒（ 24 時間）で有効期限が切れるまで、サポートされている HERE サービスに電話をかけることができます。

これで、取得した OAuth 2.0 アクセスベアラートークンを使用して、 HERE サービスに実際のリクエストを送信する準備ができました。 次の手順を実行します。

1. Postman で、新しいリクエストを作成して保存します。
2. HERE サービスエンドポイントを提供します ( この例では、次の URL を使用して HERE Map Tile API をテストします。

   https://here-tech.skawa.fun/maptile/2.1/maptile/newest/normal.day/13/4400/2686/256/png8

3. [Authorization] タブで、 [Authorization type] として [Bearer トークン ] を選択し、取得した OAuth 2.0 Bearer アクセス トークンの値を入力します。
4. リクエストを送信します。 本文に有効な応答が表示されます。 この例では、ドイツのベルリンにある拠点のベースマップタイルイメージを取得しています。

これで、アクセスキー資格情報を使用して HERE サービスにテストリクエストを作成できました。