获取最新遥测数据

GET
{host}/view_latest_telemetry_data
返回该设备一年内最新的遥测数据,如果没指定channel_index则返回设备每个通道下最新的数据点。

请求

Query Parameters
device_eui
(required)
string
设备唯一标识
channel_index
string
返回该通道下的测量值
measurement_id
string
传感器的测量值ID

响应

字段名称 说明
channel_index 通道编号
measurement_value 测量值
measurement_id 测量值id
time 测量时间

请求示例

curl --request GET \
     --url {host}/view_latest_telemetry_data?device_eui=2CF7F12010700001&measurement_id=4104&channel_index=32 \
     --user '<username>:<password>' \
     --include
     
{
    "code": "0",
    "data": [
        {
            "channel_index": 32,
            "points": [
                {
                    "measurement_value": 185,
                    "measurement_id": "4104",
                    "time": "2020-03-26T07:28:28.575Z"
                }
            ]
        }
    ]
}

接口历史版本

历史版本 说明
Sensecap V1 已停止维护,不推荐使用

获取历史遥测数据

GET
{host}/list_telemetry_data
获取指定设备的历史遥测数据。

获取指定传感器节点设备的历史数据,最长返回一个月的数据 只能查询最近三个月内的数据

请求

Query Parameters
device_eui
(required)
string
设备唯一标识
channel_index
string
返回该通道下的测量值,
如果不传参则默认返回所有通道的测量值
measurement_id
string
传感器的测量值ID
limit
number
要查询的记录条数
time_start
number
时间戳,单位是毫秒,默认一天前的时间
time_end
number
时间戳,单位是毫秒,默认当前时间

响应

返回格式采样列数据的表达方式

字段名称 说明
list[0] 通道编号及测量值id
list[1] 遥测数据,其中包含测量值及测量时间

请求示例

curl --request GET \
  --url {host}/list_telemetry_data?device_eui=2CF7F12210400082 \
  --user '<username>:<password>' \
  --include
  
{
    "code": "0",
    "data": {
        "list": [
            [[1, "4097"], [1, "4098"], [2, "4097"]],
            [
                [ [22, "2020-03-06T23:48:00Z"], [23, "2020-03-06T23:48:00Z"], [24, "2020-03-06T23:48:00Z"]]
                [ [22, "2020-03-06T23:48:00Z"], [23, "2020-03-06T23:48:00Z"] ]
                [ [22, "2020-03-06T23:48:00Z"], [23, "2020-03-06T23:48:00Z"] ]
            ]

        ]
    }
}

返回说明如下:

  • list[0][0]:表示通道及测量值id,该例中通道为1,测量值id为4097
  • list[1][0]:对应list[0][0]的测量结果
  • list[1][1]:对应list[0][1]的测量结果
  • list[1][0][0]:该例中表示通道1对应的测量值id为4097的第一个测量结果,测量值为22,测量时间为2020-03-06T23:48:00Z

接口历史版本

历史版本 说明
Sensecap V1 已停止维护,不推荐使用

获取设备遥测数据折线图

GET
{host}/aggregate_chart_points

将庞大的数据段分成小数据段,然后输出每个小段的平均值,最长返回一年的数据,每个测量量最多返回250个点,超过250个点将自动重新划分时间段返回250个点

请求

Query Parameters
device_eui
(required)
string
设备唯一标识
channel_index
string
返回该通道下的测量值,
如果不传参则默认返回所有通道的测量值
measurement_id
string
传感器的测量值ID
interval
string
要获取的时间段长度,以分钟为单位,默认60分钟
time_start
string
时间戳,单位是毫秒,默认一天前的时间
time_end
string
时间戳,单位是毫秒,默认当前时间

响应

返回格式采样列数据的表达方式

字段名称 说明
channel 通道编号
average_value 测量值平均值
measurement_id 测量值id
time 测量时间

请求示例

curl --request GET \
  --url {host}/aggregate_chart_points?device_eui=2CF7F12210400082 \
  --user '<username>:<password>' \
  --include
  
{
    "code": "0",
    "data": [
        {
            "channel": 1,
            "lists": [
                {
                    "average_value": 7.27,
                    "measurement_id": "4106",
                    "time": "2019-05-25T23:42:00.000Z"
                },
                {
                    "average_value": 6.85,
                    "measurement_id": "4106",
                    "time": "2019-05-27T10:45:00.000Z"
                }
            ]
        }
    ]
}

接口历史版本

历史版本 说明
Sensecap V1 已停止维护,不推荐使用