デバイスライセンスの作成

新しいデバイスライセンスを作成するには、ユーザーでプロジェクトを持っている必要があります。 また、プロジェクト管理者であることも必要です。これは、管理者ポータル で新しいプロジェクトを作成したか、またはプロジェクト管理者の役割を持つ既存のトラッキングプロジェクトのメンバーシップが付与されたことを意味します。 各プロジェクトには一意のappIdがあり、新しいデバイスライセンスをプロビジョニングするために必要です。

Tracking API のドキュメントでは、プロビジョニングされたデバイスライセンスを所有するユーザーをデバイス ベンダーと呼びます。

ライセンスを作成しています

前提条件

• 有効な HERE アカウント ユーザー
• 有効な トラッキングプロジェクト

ユーザーにログイン

curl -X POST \
  https://tracking.api.here.com/users/v2/login \
  -H 'Content-Type: application/json' \
  -d '{
    "email": "{userEmail}",
    "password": "{userPassword}"
}'

これにより、ユーザーアクセス トークンが返されます。accessToken。

プロジェクトのアプリケーション IDの取得

curl -X GET \
  'https://tracking.api.here.com/registry/v2/licenses' \
  -H 'Authorization: Bearer {accessToken}' \
  -H 'Content-Type: application/json'

メンバーになっているプロジェクトのリストが返されます。 各プロジェクトには、一意の appId とprojectIdがあります。 デバイスを追加するプロジェクトのappIdとprojectIdを選択します。 このガイドでは、これらのパラメーターを projectAppId およびprojectIdと呼びます 。

単一のデバイスライセンスの要求

このリクエストを使用して、 1 つのデバイスライセンスをレジストリエンドポイントに要求できます。

curl -X POST \
  https://tracking.api.here.com/registry/v2/{projectAppId}/one-device \
  -H 'Authorization: Bearer {accessToken}' \
  -H 'Content-Type: application/json'

これにより、要求 されたデバイスライセンス （ a および deviceIddeviceSecret）が返されます。

複数のデバイスライセンスの要求

または、複数のデバイスの複数のデバイスライセンスを同時に要求することもできます。 count このパラメータでは、要求されたライセンス数を指定します。 評価目的で、最大 10 のデバイスライセンスを作成できます。

デバイスライセンスのバッチリクエストの作成

curl -X POST \
  https://tracking.api.here.com/registry/v2/{projectAppId}/devices \
  -H 'Authorization: Bearer {accessToken}' \
  -H 'Content-Type: application/json' \
  -d '{
    "count": 5
}'

これにより、 ライセンス作成の進行状況をトラッキングするために使用できるjobId が戻されます。

ジョブの進行状況の確認

curl -X GET \
  'https://tracking.api.here.com/registry/v2/{jobId}/status' \
  -H 'Authorization: Bearer {accessToken}' \
  -H 'Content-Type: application/json'

これにより、ライセンス作成ジョブの進行状況を示すパーセント値が返されます。

ライセンスの取得

curl -X GET \
  'https://tracking.api.here.com/registry/v2/{jobId}/results' \
  -H 'Authorization: Bearer {accessToken}' \
  -H 'Content-Type: application/json'

要求されたデバイスライセンスが返されます。

すべてのプロビジョニング済みデバイスの一覧表示

curl -X GET \
  https://tracking.api.here.com/registry/v2/{projectAppId}/devices \
  -H 'Authorization: Bearer {accessToken}' \
  -H 'Content-Type: application/json'

によって特定されたユーザープロジェクトprojectAppIdによってプロビジョニングされたすべてのデバイスが一覧表示 されます。