传感器设备
GVP平台提供传感器数据读取的接口功能,如: 温度、照度、湿度、TVOC、CO2、PM2.5、移动探测(有人、无人)
1、查询单个传感器的状态数据
请求接口示例**,192.168.1.108是GVP服务端所在电脑的IP地址,请根据实际情况调整
http://192.168.1.108:8008/api/?HDLRequest=GetSensorData
请求方式:POST
接口地址:/api/?HDLRequest=GetSensorData
请求数据类型:application/json
响应数据类型:application/json
接口描述: 获取单个传感器设备的状态数据
Headers参数
Key | Value | 描述 |
---|---|---|
Authorization | Token值 | 登录成功时获取到的Token值,如果过期请重新登录 |
请求参数
字段 | 类型 | 是否必须 | 描述 |
---|---|---|---|
DeviceGuid | String | true | 传感器设备的GUID,只能获取GUID指定的单个传感器状态数据 |
请求示例,但是最后要使用加密方法加密字符串才提交
{"DeviceGuid":""}
响应参数:
字段 | 类型 | 描述 |
---|---|---|
ReplyCode | String | 响应码 |
ReplyMessage | String | 响应消息提示 |
ReplyDataType | Integer | 响应数据类型,可忽略 |
ReplyObject | Array | 响应数据,详细信息参考示例说明 |
响应示例:
{
"ReplyCode": "Success",
"ReplyMessage": "成功",
"ReplyDataType": 0,
"ReplyObject": {
"DeviceGuid": "d92f6417-94fa-48bd-963e-42f2e387d602", // 传感器数据的唯一GUID
"DeviceName": "会议室照度-LUX-1", // 传感器数据名称
"SensorType": 1284, // 传感器数据类型: 1281移动探测,1282温度,1283湿度,1284照度,1285TVOC,1286PM2.5,1287CO2
"DeviceOnlineState": 2, // 设备状态: 2故障,1在线
"SensorShowValue": 0.0, // 不同传器器数据类型对应的值
"UnitValue": "lux", // 传感数据的单位,照度
"RegionName": "河东企业→天河办公室→一楼→大会议室" // 传感器所在区域位置信息
},
"TotalRowCount": 0,
"AlarmCount": 0,
"PageCount": 0
}
2、查询所有传感器的状态数据
请求接口示例**,192.168.1.108是GVP服务端所在电脑的IP地址,请根据实际情况调整
http://192.168.1.108:8008/api/?HDLRequest=GetAllSensorDataList
请求方式:POST
接口地址:/api/?HDLRequest=GetAllSensorDataList
请求数据类型:application/json
响应数据类型:application/json
接口描述: 获取所有传感器设备的状态数据
Headers参数
Key | Value | 描述 |
---|---|---|
Authorization | Token值 | 登录成功时获取到的Token值,如果过期请重新登录 |
请求参数,无
请求示例,空,或任意数据,该接口忽略请求参数的校验
null,{}
响应参数:
字段 | 类型 | 描述 |
---|---|---|
ReplyCode | String | 响应码 |
ReplyMessage | String | 响应消息提示 |
ReplyDataType | Integer | 响应数据类型,可忽略 |
ReplyObject | Array<Object> | 响应数据,详细信息参考示例说明 |
响应示例:
{
"ReplyCode": "Success",
"ReplyMessage": "成功",
"ReplyDataType": 0,
"ReplyObject": [
{
"DeviceGuid": "d92f6417-94fa-48bd-963e-42f2e387d602",// 传感器数据的唯一GUID
"DeviceName": "会议室照度-LUX-1", // 传感器数据名称
"SensorType": 1284, // 传感器数据类型: 1281移动探测,1282温度,1283湿度,1284照度,1285TVOC,1286PM2.5,1287CO2
"DeviceOnlineState": 2, // 设备状态: 2故障,1在线
"SensorShowValue": 0.0, // 不同传器器数据类型对应的值
"UnitValue": "lux", // 传感数据的单位,照度
"RegionName": "河东企业→天河办公室→一楼→大会议室"
},
{
"DeviceGuid": "12da1198-8fe0-43c3-a781-47f1ea905d10",// 传感器数据的唯一GUID
"DeviceName": "空气质量传感器-TVOC-1", // 传感器数据名称
"SensorType": 1285, // 传感器数据类型: 1281移动探测,1282温度,1283湿度,1284照度,1285TVOC,1286PM2.5,1287CO2
"DeviceOnlineState": 2, // 设备状态: 2故障,1在线
"SensorShowValue": 0.0, // 不同传器器数据类型对应的值
"UnitValue": "mg/m3",// 传感数据的单位,TVOC
"RegionName": "河东企业→天河办公室→三楼→大会议室"
},
{
"DeviceGuid": "4ab9d5a6-1f78-46b0-9849-ab4319c94496",// 传感器数据的唯一GUID
"DeviceName": "空气质量传感器-Temperature-1", // 传感器数据名称
"SensorType": 1282, // 传感器数据类型: 1281移动探测,1282温度,1283湿度,1284照度,1285TVOC,1286PM2.5,1287CO2
"DeviceOnlineState": 2, // 设备状态: 2故障,1在线
"SensorShowValue": 25.0, // 不同传器器数据类型对应的值
"UnitValue": "℃", // 传感数据的单位,摄氏度
"RegionName": "河东企业→天河办公室→三楼→大会议室"
}
],
"TotalRowCount": 0,
"AlarmCount": 0,
"PageCount": 0
}