空调设备接口
GVP提供空调设备功能的查询接口和控制接口,第三方平台请根据业务需求使用相关的接口。
1、获取单个或所有空调状态数据
请求接口示例,192.168.1.108是GVP服务端所在电脑的IP地址,请根据实际情况调整
http://192.168.1.108:8008/api/?HDLRequest=GetHvacDeviceStatus
请求方式:POST
接口地址:/api/?HDLRequest=GetHvacDeviceStatus
请求数据类型:application/json
响应数据类型:application/json
接口描述: 获取单个或所有空调设备状态数据
Headers参数
Key | Value | 描述 |
---|---|---|
Authorization | Token值 | 登录成功时获取到的Token值,如果过期请重新登录 |
请求参数
字段 | 类型 | 是否必须 | 描述 |
---|---|---|---|
DeviceGuid | String | true | 功能设备的GUID,值为“all”时获取所有空调设备状态,否则只获取GUID指定的单个空调设备状态 |
请求示例,但是最后要使用加密方法加密字符串才提交
{"DeviceGuid":"all"}
响应参数:
字段 | 类型 | 描述 |
---|---|---|
ReplyCode | String | 响应码 |
ReplyMessage | String | 响应消息提示 |
ReplyDataType | Integer | 响应数据类型,可忽略 |
ReplyObject | Array<Object> | 响应数据,详细信息参考示例说明 |
响应示例:
{
"ReplyCode": "Success",
"ReplyMessage": "成功",
"ReplyDataType": 0,
"ReplyObject": [
{
"OnOff": 0, // 空调状态,0关闭,1打开
"TempStyle": 0, // 温度类型,0=℃摄氏度,1=℉华氏度
"ActualTemp": 0, // 当前室内温度
"ColdTemp": 0, // 制冷温度
"HotTemp": 0, // 制热温度
"AutoTemp": 0, // 自动温度
"DryTemp": 0, // 除湿温度
"ControlMode": 0,
"SetupMode": 0, // 设置模式,0=制冷模式,1=制热模式,2=通风模式,3=自动模式,4=除湿模式
"SetupSpeed": 0, // 设置风速,0=自动风,1=高风,2=中风,3=低风
"CurrentShowTemp": 0, // 当前显示的空调温度
"WindSweep": 0, // 是否扫风,摆风,0=关闭,1=打开
"DeviceGuid": "bd1e1ba3-1937-4058-8bd4-425658fd217b", // 空调设备唯一GUID
"DeviceName": "大会议室空调", // 空调名称
"DeviceType": 1792, // 空调类型
"VirtualZoneGuidList": "20d52391-68bd-42aa-a1c3-2aa32d27a816", // 空调设备所在区域GUID
"DeviceOnlineState": 2, // 设备状态,2故障,1在线
"ProjectGuid": null,
"DeviceHoursLife": 0,
"DeviceProtocolStyle": 0,
"ProjectName": null,
"LastCountPowerDatetime": 0
}
],
"TotalRowCount": 0,
"AlarmCount": 0,
"PageCount": 0
}
2、控制单个空调
请求接口示例,192.168.1.108是GVP服务端所在电脑的IP地址,请根据实际情况调整
http://192.168.1.108:8008/api/?HDLRequest=ControlHvacDevice
请求方式:POST
接口地址:/api/?HDLRequest=ControlHvacDevice
请求数据类型:application/json
响应数据类型:application/json
接口描述: 控制空调设备的接口,指定单个空调进行控制
Headers参数
Key | Value | 描述 |
---|---|---|
Authorization | Token值 | 登录成功时获取到的Token值,如果过期请重新登录 |
请求参数
字段 | 类型 | 是否必须 | 描述 |
---|---|---|---|
DeviceGuid | String | true | 空调设备唯一Guid |
ActionEnumAir | String | true | 控制空调的动作类型:CustomTemperature自定义温度,TurnOff关闭,TurnOn打开,SetMode_Cold制冷模式,SetMode_Hot制热模式,SetMode_Fan通风模式,SetMode_Auto自动模式,SetMode_Dry除湿模式,SetSpeed_Auto自动风,SetSpeed_High高风,SetSpeed_Middle中风,SetSpeed_Low低风 |
CustomTempValue | int | true | 控制空调自定义温度对应的值:温度值,动作类型为CustomTemperature自定义温度时处理 |
请求示例,但是最后要使用加密方法加密字符串才提交
{"DeviceGuid":"","ActionEnumAir":"","CustomTempValue":0}
响应参数:
字段 | 类型 | 描述 |
---|---|---|
ReplyCode | String | 响应码 |
ReplyMessage | String | 响应消息提示 |
ReplyDataType | Integer | 响应数据类型,可忽略 |
ReplyObject | Array | 响应数据,详细信息参考示例说明 |
响应成功示例:
{
"ReplyCode": "Success",
"ReplyMessage": "成功",
"ReplyDataType": 0,
"ReplyObject": {},
"TotalRowCount": 0,
"AlarmCount": 0,
"PageCount": 0
}