区域信息接口
GVP提供区域信息查询接口,GVP的设备功能点是必须存放在某个区域里显示的,查询得到所有区域信息,包含了区域的层级结构信息等,第三方平台可根据业务需求处理区域信息的功能。
查询所有区域信息
请求接口示例,192.168.1.108是GVP服务端所在电脑的IP地址,请根据实际情况调整
http://192.168.1.108:8008/api/?HDLRequest=ZoneListShow
请求方式:POST
接口地址:/api/?HDLRequest=ZoneListShow
请求数据类型: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": [
{
"ZoneGuid": "0d6ab5c5-3778-4bec-9d0b-f8e403ec7fdb", // 区域信息唯一GUID
"ZoneName": "一楼", // 区域信息的名称
"ZoneLevel": "0.ec95ce37-6be8-4dc8-bb02-b989053b4665.a62fdf31-efaf-494d-89e6-c76d856f8d10", // 区域信息的层级结构,0是最顶层,以.号间隔,不包含自己,最后一个是父级区域GUID
"ZoneLevelName": "河东企业→天河办公室→一楼", // 区域信息的层级结构,以→符号间隔
"ParentZoneGuid": "a62fdf31-efaf-494d-89e6-c76d856f8d10", // 当前区域的上一级区域GUID,父级区域GUID
"SeqNumber": 1,
"ZoneVisible": 0, // 区域是否可见: 0可见,1不可见
"ZoneCreateTime": "2021-11-29T15:15:26",
"ZoneMoreMessage": "",
"ZoneSource": "0",
"ZoneLayout": 0,
"BackGroundShowType": 0,
"ZoneBackColor": "#ffffff",
"ZoneBmgIconUrl": "",
"ZoneBmgSize": "1750-810",
"AllTurnOn": 1,
"AllTurnOff": 1,
"ProjectGuid": "0"
},
{
"ZoneGuid": "16706ee3-9837-4582-b732-479a88d55db4", // 区域信息唯一GUID
"ZoneName": "地产销售部", // 区域信息的名称
"ZoneLevel": "0.ec95ce37-6be8-4dc8-bb02-b989053b4665.a62fdf31-efaf-494d-89e6-c76d856f8d10.0d6ab5c5-3778-4bec-9d0b-f8e403ec7fdb", // 区域信息的层级结构,0是最顶层,以.号间隔,不包含自己,最后一个是父级区域GUID
"ZoneLevelName": "河东企业→天河办公室→一楼→地产销售部", // 区域信息的层级结构,以→符号间隔
"ParentZoneGuid": "0d6ab5c5-3778-4bec-9d0b-f8e403ec7fdb", // 当前区域的上一级区域GUID,父级区域GUID
"SeqNumber": 6,
"ZoneVisible": 0, // 区域是否可见: 0可见,1不可见
"ZoneCreateTime": "2022-02-18T10:31:14",
"ZoneMoreMessage": "",
"ZoneSource": "0",
"ZoneLayout": 0,
"BackGroundShowType": 0,
"ZoneBackColor": "#ffffff",
"ZoneBmgIconUrl": "",
"ZoneBmgSize": "1750-810",
"AllTurnOn": 1,
"AllTurnOff": 1,
"ProjectGuid": "0"
}
],
"TotalRowCount": 0,
"AlarmCount": 0,
"PageCount": 0
}