获取设备状态列表

接口简述

通过 Neptune API 获取设备状态列表

请求地址

/device/deviceStatusList

请求方式

GET

请求参数

序号	名称	必填	描述
1	app_id	是	开发者账号
2	app_secret	是	开发者密码
3	uuid	是	设备序列号
4	start_date	是	开始时间(格式为'YYYY-MM-DD HH:mm:ss')
5	end_date	否	结束时间(格式为'YYYY-MM-DD HH:mm:ss')
6	status_type	否	设备状态,默认全部 normal=正常 warning=异常 alarm=报警
7	status_value	否	状态值,如查询多个,可用逗号(,)隔开,如:1001,1002,1003

请求示例

// 使用jQuery AJax作为请求提交工具
$.ajax({
  type: "get",
  url: "https://api.neptune-iiot.net/device/deviceStatusList",
  dataType: "json",
  data: {
    app_id: "nep6ad37b8ea",
    app_secret: "af0c14f638165eff5c1df5f693a6cab0",
    uuid: "2040-60BF-B876-4537",
    start_date: "2021-08-18 00:00:00",
  },
});

返回值说明

返回值格式为 JSON

序号	名称	描述
1	code	请求状态: 200 = 请求成功； 401 = Token 授权失败； 1001 = 设备不存在；
2	message	请求状态描述
3	data.statusList	状态列表
4	data.statusList.device_name	设备名称
5	data.statusList.uuid	设备 uuid
6	data.statusList.triggered_date	开始时间
7	data.statusList.changed_date	结束时间
8	data.statusList.duration	持续时间(单位为毫秒)
9	data.statusList.status_type	设备状态
10	data.statusList.status_value	状态值
11	data.statusList.status_desc	状态描述

返回值示例

{
    "code": 200,
    "message": "请求成功",
    "data": {
        "statusList": [
            {
                "device_name": "灯泡",
                "uuid": "2040-60BF-B876-4537",
                "duration": 4104,
                "triggered_date": "2021-08-18 15:50:48.974",
                "changed_date": "2021-08-18 15:50:53.078",
                "status_type": "alarm",
                "status_value": "3",
                "status_desc": "温度过高"
            }
        ]
    }
}