デバイスの所有権の要求

デバイスがトラッキング API 経由でデータを送信し、トラッキングバックエンドに保存できるようにするには、エンド ユーザー がデバイスを要求する必要があります。 未請求のデバイスは、Tracking API と通信できません。

Tracking API では、デバイスを請求したエンド ユーザー をデバイス 所有者と呼びます。 デバイス所有者は、デバイスを制御し、そのデバイスによって取得されたデータに 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。

ユーザープロジェクトにデバイスを追加

次のリクエストをregistry エンドポイントに送信します。 ユーザーが複数のプロジェクトのメンバーである場合 は、projectIdクエリ パラメーター でターゲットプロジェクト ID を指定する必要があります ( これはprojectAppIdとは異なります ) 。

注 : 1 つはデバイスdeviceIdを 要求するだけで、もう 1 つdeviceSecretは必要ありません。

curl -X PUT \
  https://tracking.api.here.com/registry/v2/devices/{deviceId}?projectId=`projectId` \
  -H 'Authorization: Bearer {accessToken}' \
  -H 'Content-Type: application/json'

新たに作成された trackingIdが返されます。 これは、トラッキングバックエンドのデバイスデータに関連付けられている一意の識別子です。

注 : trackingId は、ライセンスで使用されているdeviceIdと異なります。 deviceId は、ハードウェアに永続的に関連付けられ、 trackingId はデバイスデータに関連付けられています。 デバイスが後で販売または転送され た場合、deviceId は同じままですが 、 trackingIdは、デバイスが再利用されたときに変更されます。 この方法では、新しい所有者は古いデータにアクセスできません。

デバイスがユーザーのデバイスリストに含まれていることの確認

users エンドポイントに GET リクエストを送信します。 ユーザーが複数のプロジェクトのメンバーである場合 、projectId は、クエリ パラメーター でターゲットプロジェクト ID を指定する必要があります。

curl -X GET \
  https://tracking.api.here.com/users/v2/devices?projectId=`projectId` \
  -H 'Authorization: Bearer {accessToken}'

これ projectIdにより、によって特定されたユーザープロジェクトによって請求されたすべてのデバイスが一覧表示されます。

「」に一致する結果は 件です

    「」に一致する結果はありません