デバイスがTracking APIにデータを送信する前に、デバイスをプロビジョニングする必要があります。

ユーザーログイン

HERE Tracking APIにユーザーとしてログインし、accessTokenを取得します。

デバイスをプロビジョニングする

仮想デバイスをプロビジョニングする場合、仮想デバイスの所有者はプロビジョニングリクエストでデバイスIDを作成して指定します。仮想デバイスidはプロジェクト固有です。仮想デバイスがプロビジョニングされると、idはexternalIdと呼ばれ、プロジェクトのappIdとともにデバイスを一意に識別するために使用されます。詳細については、以下を参照してください。複数のデバイスのライセンスを作成する

curl -X POST \
  https://{tcHost}/registry/v2/{projectAppId}/devices \
  -H 'Authorization: Bearer {token}' \
  -H 'Content-Type: application/json' \
  -d '{
    "devices": [
      {
        "id": "my-first-device"
      },
      {
        "id": "my-second-device"
      }
    ]
}'

{
  "jobId": "344a17a4-1b19-4420-bb6f-8400b87071fd"
}

レスポンスはjobIdで、これを使用して結果を取得できます。

ジョブの進行状況を確認する

詳細については、「複数デバイスのライセンスリクエストジョブのステータスを取得する」を参照してください。

curl -X GET \
  'https://{tcHost}/registry/v2/{jobId}/status' \
  -H 'Authorization: Bearer {accessToken}' \
  -H 'Content-Type: application/json'

{
  "percent": 100,
  "status": "complete"
}

デバイスのライセンスを取得する

詳細については、「複数デバイスのライセンスリクエストジョブの結果を取得する」を参照してください。

curl -X GET \
  'https://{tcHost}/registry/v2/{jobId}/results' \
  -H 'Authorization: Bearer {accessToken}' \
  -H 'Content-Type: application/json'

{
  "data": [
    {
      "deviceId": "VRDE-11111111-2222-3333-4444-555555555555",
      "externalId": "my-first-device"
    },
    {
      "deviceId": "VRDE-22222222-2222-3333-4444-555555555555",
      "externalId": "my-second-device"
    }
  ],
  "count": 2
}

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

詳細については、「ユーザーによってプロビジョニングされたすべてのデバイスを一覧表示する」を参照してください。

curl -X GET \
  https://{tcHost}/registry/v2/{projectAppId}/devices \
  -H 'Authorization: Bearer {accessToken}' \
  -H 'Content-Type: application/json'
{
  "count": 2,
  "data": [
    {
      "deviceId": "VRDE-11111111-2222-3333-4444-555555555555",
      "externalId": "my-first-device",
      "appId": "A1abc2dEFg3HiJKlMN45",
      "timestamp": 1718002070189
    },
    {
      "deviceId": "VRDE-22222222-3333-4444-5555-666666666666",
      "externalId": "my-second-device",
      "appId": "A1abc2dEFg3HiJKlMN45",
      "timestamp": 1718002070190
    }
  ]
}

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

次のステップ

デバイスのプロビジョニングが完了したら、ユーザープロジェクトにデバイスを登録する手順に進みます。