ガイドAPIリファレンス
ガイド

デバイスの必要な構成を設定する

デバイスのシャドウ機能を使用して、デバイスの設定を管理できます。これは最後に報告された状態と、デバイスに送信された設定 (それぞれreportedおよびdesiredシャドウと呼ばれます) を含むデバイスのオンライン表現です。 デバイスがHERE Tracking APIにデータを取り込むと、desiredシャドウを含むJSONオブジェクトがレスポンスとして返ります。

必要な設定を行う

デバイスで設定を行い、値をデバイスshadowに保存するには、shadowsエンドポイントを使用します。新しいデバイス設定を行うと、デバイスのシャドウのstateVersionプロパティが増加します。次回、デバイスがAPIにデータを取り込むときに、新しいstateVersionを持つdesiredシャドウの形式で設定を受け取ります。 trackingIdはユーザーが登録した仮想デバイスのトラッキングIDです。

curl -X PUT \
  https://{tcHost}/shadows/v2/{trackingId} \
  -H 'authorization: Bearer {userToken}' \
  -H 'content-type: application/json' \
  -d '{
    "desired": {
        "payload": {
            "led": "red"
        }
    }
}'