设备数据API

GET
{host}/device/list_euis
这是一个获取组织账号下所有设备EUI的便捷方法。

返回示例

{
    "code": "0",
    "data": {
        "gateway": [
            "2CF7F1........",
            "2CF7F1........",
            "2CF7F1........"
        ],
        "node": [
            "2CF7F1........",
            "2CF7F1........",
            "2CF7F1........",
            "2CF7F1........",
            "2CF7F1........"
        ]
    }
}

请求示例

curl --request GET \
  --url {host}/device/list_euis \
  --user '<username>:<password>'

获取设备最新数据

GET
{host}/channel/view_latest/:node_eui

返回设备一年内最新的一条遥测数据

Path Parameters
node_eui
(required)
string
节点设备唯一标识
Query Parameters
measure_id
string
传感器的测量值ID
channel
string
返回该通道下的测量值，
如果不传参则默认返回所有通道的测量值

返回示例

{
    "code": "0",
    "data": [
        {
            "channel": "32", // channel number
            "points": [
                {
                    "value": "185", // the measurement value
                    "measurement_id": "4104", // the measurement id
                    "created": "1585207708575" // when the record is created 
                }
            ]
        }
    ]
}

请求示例

curl --request GET \
     --url {host}/channel/view_latest/:node_eui?measure_id:measure_id&channel:channel \
     --user '<username>:<password>' \
     --include

获取设备历史数据

GET
{host}/channel/view_raw/:node_eui
获取指定传感器节点设备的历史数据。

获取指定传感器节点设备的历史数据，最多返回一个月范围的数据。

Path Parameters
node_eui
(required)
string
节点设备唯一标识
Query Parameters
measure_id
string
传感器的测量值ID
channel
string
返回该通道下的测量值，
如果不传参则默认返回所有通道的测量值
limit
number
要查询的记录条数，最多400条
time_start
number
时间戳，单位是毫秒
time_end
number
时间戳，单位是毫秒

返回示例

{
    "code": "0",
    "data": [
        {
            "channel": "1", // channale number
            "points": [
                {
                    "measurement_id": "4099", // the measurement id
                    "value": "0",  // measurement value
                    "created": "1585207694901" // when the record is created 
                },
                {
                    "measurement_id": "4099",
                    "value": "0",
                    "created": "1585207626265"
                }
            ],
            "channel_name": ""
        },
        {
            "channel": "2",
            "points": [
                {
                    "measurement_id": "4102",
                    "value": "25.7",
                    "created": "1585207695572"
                },
                {
                    "measurement_id": "4103",
                    "value": "0.0",
                    "created": "1585207695572"
                }
            ],
            "channel_name": ""
        }
    ]
}

请求示例

curl --request GET \
  --url {host}/channel/view_raw/:node_eui?limit=:limit&time_start=:time_start&time_end=:time_end \
  --user '<username>:<password>' \
  --include

获取设备数据段

GET
{host}/channel/view_segment/:node_eui

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

Path Parameters
node_eui
(required)
string
节点设备唯一标识
Query Parameters
measure_id
string
传感器的测量值ID
channel
string
返回该通道下的测量值，
如果不传参则默认返回所有通道的测量值
segment
string
要获取的时间段长度，以分钟为单位,默认60分钟
time_start
string
时间戳，单位是毫秒
time_end
string
时间戳，单位是毫秒

返回示例

{
    "code": "0",
    "data": [
        {
            "channel": "1", // channel number
            "lists": [
                {
                    "avg": "9.72",  // avgrage value of the segment
                    "measurement_id": "4099", // the measurement id
                    "created": "1556051760000"
                },
                {
                    "avg": "6.07",
                    "measurement_id": "4099",
                    "created": "1556177940000"
                }
            ]
        }
    ]
}

请求示例

curl --request GET \
  --url {host}/channel/view_segment/:node_eui?measure_id:measure_id&channel:channel&segment:segment&time_start:time_start&time_end:time_end \
  --user '<username>:<password>' \
  --include