cloud-to-cloud コネクタ

Tracking API は 、 SigFox デバイスクラウドへのcloud-to-cloud間接続をサポートしています。 この接続は、 SigFox クラウドから SigFox アカウントのデバイスのレポートを受信するcloud-to-cloudコネクタを作成することで形成され、 トラッキングバックエンドで仮想デバイスを自動的に作成して、 SigFox デバイスレポートを Tracking API への入力に変換します。 したがって、トラッキングバックエンドを使用して SigFox デバイスを追跡できます。

前提条件

ログイン

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

HERE アカウントaccessTokenが返されます。

SigFox Cloud-to-Cloud Connector を作成

利用可能なcloud-to-cloud のドライバーを取得

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

これにより、利用可能なcloud-to-cloudのドライバーの配列が返されます。 SigFox Cloud のドライバーに providersigfox はとがあり driverIdDRV-bf8642c2-f163-40f9-863c-b2ea85d6378cます。

cloud-to-cloud コネクターを作成します

cloud-to-cloudコネクタを作成するに は、 C2C エンドポイントPOST要求を送信します。 複数のプロジェクトのメンバーの場合 projectId は、クエリ パラメーター でプロジェクト ID を指定してください。

externalCloudInfo リクエスト本文のオブジェクトには、追跡する SigFox デバイスの SigFox API アクセス資格情報およびデバイスタイプ ID が含まれている必要があります。 これらは、 SigFox アカウントのログイン資格情報ではなく、 API が SigFox デバイスグループの資格情報にアクセスすることに注意してください。

curl -X POST \
  https://tracking.api.here.com/c2c/v4/connectors?projectId=`projectId` \
  -H 'Authorization: Bearer {accessToken}' \
  -H 'Content-Type: application/json' \
  -d '{
      "name": "Name for C2C connector",
      "description": "Description for C2C connector",
      "externalCloudInfo": {
        "login": "sigfoxApiAccessLogin",
        "password": "sigfoxApiAccessPassword",
        "deviceType": "sigfoxDeviceTypeId"
      },
      "driverId": "DRV-bf8642c2-f163-40f9-863c-b2ea85d6378c",
      "refreshIntervalS": 600,
      "enabled": true
}'

作成されたコネクタは、refreshIntervalS秒ごとに定期的に実行されます。これは、デバイスレポートが処理される間隔です。

cloud-to-cloud コネクターのリストを取得

curl -X GET \
  https://tracking.api.here.com/c2c/v4/connectors?projectId=`projectId` \
  -H 'Authorization: Bearer {accessToken}' \
  -H 'Content-Type: application/json'

これにより、プロジェクト用に作成されたcloud-to-cloudコネクターの配列が返されます。 複数のプロジェクトのメンバーの場合 projectId は、クエリ パラメーター でプロジェクト ID を指定してください。

クラウド内の外部デバイスデータを表示

外部デバイスのリストを取得

curl -X GET \
  https://tracking.api.here.com/c2c/v4/connectors/{connectorId}/ext-devices \
  -H 'Authorization: Bearer {accessToken}' \
  -H 'Content-Type: application/json'

コネクタに登録されている外部デバイスの配列が返されます。 応答の中のexternalDeviceIdは外部クラウドのデバイス ID であり 、トラッキング API でデバイスを識別するときに、プロジェクトappIdと一緒に仮想デバイスexternalIdとして使用されます。

外部デバイスのシャドウとトレースは 、物理デバイスと同じ方法で照会できます。

外部デバイスのシャドウを取得

curl -X GET \
  'https://tracking.api.here.com/shadows/v2/{externalDeviceId}?appId=`appId`' \
  -H 'Authorization: Bearer {accessToken}' \
  -H 'content-type: application/json'

これにより、外部デバイスの最新のreporteddesiredシャドウが返されます。

外部デバイスのトレースを取得

curl -X GET \
  'https://tracking.api.here.com/traces/v2/{externalDeviceId}?appId=`appId`' \
  -H 'Authorization: Bearer {accessToken}' \
  -H 'content-type: application/json'

外部デバイスのトレースが返されます。

cloud-to-cloud コネクターを削除

cloud-to-cloudコネクタを削除しても、Tracking バックエンドから外部デバイスは削除されません。

curl -X DELETE \
  https://tracking.api.here.com/c2c/v4/connectors/{connectorId} \
  -H 'Authorization: Bearer {accessToken}' \
  -H 'Content-Type: application/json'

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

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