3.1.4.5 プロパティ レポートの履歴データを照会する

デバイスが Milesight 開発プラットフォームに追加されると、現在のステータス、収集データなどのプロパティデータが定期的にプラットフォームに報告されます。このトピックでは、デバイスプロパティレポートの履歴データを照会するためのインターフェースについて紹介します。

リクエスト URL

GET {base_url}/device/openapi/v1/devices/{deviceId}/properties/history?{query parameters}

リクエストパラメータ

表 1. ヘッダーパラメータ
パラメータ 必須 タイプ 説明
Authorization Yes String API 呼び出しを行うための有効なアクセストークン。

形式は Bearer {access_token} である必要があります。

表 2. パスパラメータ
パラメータ 必須 タイプ 説明
deviceId Yes Long このデバイスの一意の ID。デバイスを追加するときに返されます。

注: deviceID を保存していない場合は、特定のデバイスを検索を使用してデバイスの ID を照会できます。

表 3. クエリパラメータ
パラメータ 必須 タイプ 説明
startTime No Long 記録のクエリの開始時刻を、Unix タイムスタンプ(単位:ミリ秒)の形式で指定します。
endTime No Long 記録のクエリの終了時刻を、Unix タイムスタンプ(単位:ミリ秒)の形式で指定します。
pageSize No Integer  1 ページあたりの記録の数を定義します。
pageKey No String このパラメータは、最初のリクエストでは必要ありません。応答に nextPageKeyが含まれている場合、それは後続のページに追加データがあることを示します。

残りのレコードを取得するには、後続のリクエストに、前のクエリ結果の nextPageKeyの値をこのパラメータとして含めてください。

order No String 表示順を定義します。

有効な値

  • asc: Ascending order.
  • desc: Descending order.

重要:クエリパラメータがパスされていない場合、データストレージが有効になっていると、デフォルトで過去 1 日間のすべてのプロパティのデータを返します。

応答パラメータ

 
パラメータ タイプ 説明
data Object<Device_Info> クエリしたデバイスの詳細情報。
status String API リクエストの結果。

  • Success
  • Failed
requestId String リクエストの一意の ID。リクエストをすばやく見つけるために使用できます。
Device_Info
 
パラメータ タイプ 説明
list Array
報告記録のデバイスプロパティのリスト
ts Integer
報告時刻のタイムスタンプ
properties JSON
報告されたデータの詳細
pageSize Integer
各ページに表示される記録の数。
nextPageKey String
次の記録のページへのキー。次の API リクエストでこの値を使用して、次のページのデータを取得します。

リクエスト例
データ保存が有効になっている場合、デバイス ID「1739930666380779522」のデバイスが過去 1 日間に報告したデータを照会します。
GET /device/openapi/v1/devices/1739930666380779522/properties/history
Host: demo.milesight.com
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6InllYXN0b25lLWRlZmF1bHQta2V5LWlkIn0.eyJncmFudF90eXBlIjoiY2xpZW50X2NyZWRlbnRpYWxzIiwic2NvcGUiOlsib3BlbmFwaSJdLCJjbGllbnRfZXh0Ijp7ImFwcF9pZCI6IjE3MzY5NTQ4MDE3MTMzMjgxMzAifSwiZXhwIjoxNzAzMjEzMDk4LCJhdXRob3JpdGllcyI6WyJST0xFX0NMSUVOVCJdLCJqdGkiOiJiYjJjN2U4Yy03NGQwLTQ4NjEtODE3MS1iYTc0NWRlMGY0NmQiLCJjbGllbnRfaWQiOiI4OTNkNzdjNy1mMGNiLTRmMzQtOWNhMS03YzJhNGNmMTEzNDgiLCJ0cyI6MTcwMzIwOTQ5ODMzNH0
Content-Type: application/json
レスポンス例
HTTP/1.1 200 OK
{
    "data":{
        "list":[
            {
                "ts": "1703046615852"
                "properties":{
                    "temperature": 24,
                    "humidity": 84,
                    "pir": true,
                    "illumiance":0,
                    "co2":573,
                    "tvoc":100,
                    "barometric_pressure":10231,
                    "pm2_5":8,
                    "pm10":8
                }
            },
            {
                "ts": "170304553283"
                "properties":{
                    "temperature": 26,
                    "humidity": 72,
                    "pir": true,
                    "illumiance":0,
                    "co2":411,
                    "tvoc":100,
                    "barometric_pressure":10193,
                    "pm2_5":7,
                    "pm10":8
                }
            }
        ]
    }
    "status": "Success",
    "requestId": "4c446ddf993fd3643f5e076498a992b5"
}

関連記事

ソリューション / IoT サポート


Milesight製品

ウェーブクレスト株式会社が運営するMilesight製品特設サイトです

居住者の健康を確保

お知らせ

  1. 2025-4-3

    ピープル・センシング 駆動型スマートビルディング

    People Sensing Insights を通じてビルインテリジェンスに革命をもたらします。…
  2. 2023-7-21

    LoRaWANの説明: 理論から実践へのガイド

    この包括的なビデオでは、LoRaWANを深く掘り下げ、その仕組み、利点、アプリケーションについて説明…
  3. 2023-4-6

    センシング・インサイト Milesight リブランディングのお知らせ

    https://youtu.be/r40DK40DjIY …
ページ上部へ戻る