-
请求示例 HTTP的示例 GET /controller/campus/v1/indoormapservice/floors/75ade72a-e7a9-4c81-8fca-894e7ca9c2c2 HTTP/1.1
Host: 192.168.1.125:18002
Content-Type: application/json
Accept: application/json
Accept-Language: en-US
X-AC
CES S-TOKEN: x-yyyyyy
-
响应参数 返回状态码为200:查询成功,响应体参考QueryFloorDetailsResponse。 表2 QueryFloorDetailsResponse对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errcode string - - 错误码。 "0" errmsg string - - 错误信息。 "error" data REFERENCE 详细请参见表3。 楼层详细信息 - 表3 FloorDetails对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 name string - - 楼层名称。 "F3" number string - - 楼层号。 "7" image byte - - 楼层图纸。 "iVBORw0KGgoAAAANSUhEUgAAAEIAAAA8CAYAAADSfGxZAAAACXBIWXMAAA7EAAAOxAGVKw4bAAAAEXRFWHRTb2Z0d2FyZQBTbmlwYXN0ZV0Xzt0AAAEKSURBVGiB7dvRaoMwGEDhP3Hv/4I+hPei/rs5Slo2lw1KITsHSi0m0X54acpxHBkRUUqJiIjMvI6fuzv3fD4zo123Z87dmLOvxvZe625s/XHmP0kIEoKEICFICBKChCAhSAgSgoQgIUgIEoKEICFICBKChCAhSAgSgoQgIUgIEoKEICFICBKChCAhSAgSgoQgIUgIEoKEICFICBKChKChINqX13/bUBDtG/cnSi/OUBCZGeu6xrZtDwA9GMNBzPMcy7Jcv9vvu8pIG1cy81rv/Hw3duiNK7XWqPXxL+373jf3FTf07k6MzIxpmrrmfLzyht7R+cj37O9qG/KJ+EtCkBAkBAlBQpAQ9AkRmWqufm0+xwAAAABJRU5ErkJggg==" scale double - - 比例尺,表示图上距离与实际距离的比,例如:图上0.01米代表实际1米,则比例尺为0.01。 "0.022" 返回状态码为400:请求参数错误,无响应体。 详细信息请参见实际响应消息体。 返回状态码为500:内部服务器错误,无响应体。 详细信息请参见实际响应消息体。
-
响应示例 返回状态码为200:查询成功,响应体参考QueryFloorDetailsResponse。 HTTP/1.1 200 OK
Date: Sun,11 May 2025 10:00:00 GMT
Server: example-server
Content-Type: application/json;charset=UTF-8
Content-Length: 250
Connection: keep-alive
{
"errcode" : "0",
"errmsg" : "error",
"data" : {
"name" : "F3",
"number" : "7",
"image" : "iVBORw0KGgoAAAANSUhEUgAAAEIAAAA8CAYAAADSfGxZAAAACXBIWXMAAA7EAAAOxAGVKw4bAAAAEXRFWHRTb2Z0d2FyZQBTbmlwYXN0ZV0Xzt0AAAEKSURBVGiB7dvRaoMwGEDhP3Hv/4I+hPei/rs5Slo2lw1KITsHSi0m0X54acpxHBkRUUqJiIjMvI6fuzv3fD4zo123Z87dmLOvxvZe625s/XHmP0kIEoKEICFICBKChCAhSAgSgoQgIUgIEoKEICFICBKChCAhSAgSgoQgIUgIEoKEICFICBKChCAhSAgSgoQgIUgIEoKEICFICBKChKChINqX13/bUBDtG/cnSi/OUBCZGeu6xrZtDwA9GMNBzPMcy7Jcv9vvu8pIG1cy81rv/Hw3duiNK7XWqPXxL+373jf3FTf07k6MzIxpmrrmfLzyht7R+cj37O9qG/KJ+EtCkBAkBAlBQpAQ9AkRmWqufm0+xwAAAABJRU5ErkJggg==",
"scale" : "0.022"
}
} 返回状态码为400:请求参数错误,无响应体。 HTTP/1.1 400 Bad Request
Date: Sun,11 May 2025 10:00:00 GMT
Server: example-server
Content-Type: application/json;charset=UTF-8
Content-Length: 250
Connection: keep-alive
返回状态码为500:内部服务器错误,无响应体。 HTTP/1.1 500 Internal Server Error
Date: Sun,11 May 2025 10:00:00 GMT
Server: example-server
Content-Type: application/json;charset=UTF-8
Content-Length: 250
Connection: keep-alive
-
响应示例 返回状态码为200:查询成功,响应体参考QueryLocatedDeviceDetailsResponse。 HTTP/1.1 200 OK
Date: Sun,11 May 2025 10:00:00 GMT
Server: example-server
Content-Type: application/json;charset=UTF-8
Content-Length: 250
Connection: keep-alive
{
"errcode" : "0",
"errmsg" : "error",
"data" : [
{
"id" : "c2b378d8-145f-4e46-8d71-c3709695dd06",
"name" : "AP6605",
"status" : "0",
"esn" : "AA50082925AAAA001154",
"mac" : "xx:xx:xx:xx:xx:xx",
"description" : "HUAWEI",
"apType" : "cloud AP",
"positionX" : "32",
"positionY" : "32",
"planPositionX" : "32",
"planPositionY" : "32",
"planPointId" : "75ade72a-e7a9-4c81-8fca-894e7ca9c2c2"
}
]
} 返回状态码为400:请求参数错误,无响应体。 HTTP/1.1 400 Bad Request
Date: Sun,11 May 2025 10:00:00 GMT
Server: example-server
Content-Type: application/json;charset=UTF-8
Content-Length: 250
Connection: keep-alive
返回状态码为500:内部服务器错误,无响应体。 HTTP/1.1 500 Internal Server Error
Date: Sun,11 May 2025 10:00:00 GMT
Server: example-server
Content-Type: application/json;charset=UTF-8
Content-Length: 250
Connection: keep-alive
-
响应参数 返回状态码为200:查询成功,响应体参考QueryLocatedDeviceDetailsResponse。 表3 QueryLocatedDeviceDetailsResponse对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errcode string - - 错误码。 "0" errmsg string - - 错误信息。 "error" data ARRAY_REFERENCE 详细请参见表4。 已布放设备详情列表。 - 表4 LocatedDeviceDetails对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 id string - - 设备ID,格式UUID。 "c2b378d8-145f-4e46-8d71-c3709695dd06" name string - - 设备名称。 "AP6605" status string 0 1 3 4 - 设备状态 0: 正常 1: 告警 3: 离线 4: 未注册 "0" esn string - - 设备ESN号。 "AA50082925AAAA001154" mac string - - MAC地址。 "xx:xx:xx:xx:xx:xx" description string - - 设备备注信息。 "HUAWEI" apType string cloud AP distributed AP cloud central AP - AP分类 cloud AP:云AP distributed AP:云分布式AP cloud central AP:云中心AP "cloud AP" positionX int32 - - 设备布放坐标X,单位:像素。 "32" positionY int32 - - 设备布放坐标Y,单位:像素。 "32" planPositionX int32 - - 设备规划坐标X,单位:像素。 "32" planPositionY int32 - - 设备规划坐标Y,单位:像素。 "32" planPointId string - - 网规规划点ID,格式UUID。 "75ade72a-e7a9-4c81-8fca-894e7ca9c2c2" 返回状态码为400:请求参数错误,无响应体。 详细信息请参见实际响应消息体。 返回状态码为500:内部服务器错误,无响应体。 详细信息请参见实际响应消息体。
-
请求示例 HTTP的示例 GET /controller/campus/v1/indoormapservice/floors/75ade72a-e7a9-4c81-8fca-894e7ca9c2c2/devices-details HTTP/1.1
Host: 192.168.1.125:18002
Content-Type: application/json
Accept: application/json
Accept-Language: en-US
X-ACCESS-TOKEN: x-yyyyyy
-
URI /controller/campus/v1/indoormapservice/floors/{floorId}/devices-details 表1 path参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 floorId 是 uuid 36个字符。 - 楼层ID,格式UUID。 "75ade72a-e7a9-4c81-8fca-894e7ca9c2c2" 表2 query参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 deviceType 否 string AP LSW ALL ALL 设备类型,类型取值范围:"AP" - 接入点,"LSW" - 交换机,"ALL" - 所有。默认值为"ALL"。 -
-
响应参数 返回状态码为200:查询成功,响应体参考QueryBuildingsResponse。 表2 QueryBuildingsResponse对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errcode string - - 错误码。 "0" errmsg string - - 错误信息。 "error" data ARRAY_REFERENCE 详细请参见表3。 楼栋列表。 - 表3 BuildingDto对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 id string - - 楼栋ID,格式UUID。 "75ade72a-e7a9-4c81-8fca-894e7ca9c2c2" name string - - 楼栋名称。 "N1" floorList ARRAY_REFERENCE 0-1000个列表项,详细请参见表4。 楼层列表。 - 表4 FloorDto对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 id string - - 楼层ID,格式UUID。 "75ade72a-e7a9-4c81-8fca-894e7ca9c2c2" number string - - 楼层号。 "7" name string - - 楼层名称。 "F2" 返回状态码为400:请求参数错误,无响应体。 详细信息请参见实际响应消息体。 返回状态码为500:内部服务器错误,无响应体。 详细信息请参见实际响应消息体。
-
响应示例 返回状态码为200:查询成功,响应体参考QueryBuildingsResponse。 HTTP/1.1 200 OK
Date: Sun,11 May 2025 10:00:00 GMT
Server: example-server
Content-Type: application/json;charset=UTF-8
Content-Length: 250
Connection: keep-alive
{
"errcode" : "0",
"errmsg" : "error",
"data" : [
{
"id" : "75ade72a-e7a9-4c81-8fca-894e7ca9c2c2",
"name" : "N1",
"floorList" : [
{
"id" : "75ade72a-e7a9-4c81-8fca-894e7ca9c2c2",
"number" : "7",
"name" : "F2"
}
]
}
]
} 返回状态码为400:请求参数错误,无响应体。 HTTP/1.1 400 Bad Request
Date: Sun,11 May 2025 10:00:00 GMT
Server: example-server
Content-Type: application/json;charset=UTF-8
Content-Length: 250
Connection: keep-alive
返回状态码为500:内部服务器错误,无响应体。 HTTP/1.1 500 Internal Server Error
Date: Sun,11 May 2025 10:00:00 GMT
Server: example-server
Content-Type: application/json;charset=UTF-8
Content-Length: 250
Connection: keep-alive
-
请求示例 HTTP的示例 GET /controller/campus/v1/indoormapservice/sites/75ade72a-e7a9-4c81-8fca-894e7ca9c2c2/buildings HTTP/1.1
Host: 192.168.1.125:18002
Content-Type: application/json
Accept: application/json
Accept-Language: en-US
X-ACCESS-TOKEN: x-yyyyyy
-
响应示例 返回状态码为200:查询成功,响应体参考QueryFloorLocationDetailsResponse。 HTTP/1.1 200 OK
Date: Sun,11 May 2025 10:00:00 GMT
Server: example-server
Content-Type: application/json;charset=UTF-8
Content-Length: 250
Connection: keep-alive
{
"errcode" : "0",
"errmsg" : "error",
"data" : {
"name" : "F3",
"buildingName" : "N1",
"image" : "iVBORw0KGgoAAAANSUhEUgAAAEIAAAA8CAYAAADSfGxZAAAACXBIWXMAAA7EAAAOxAGVKw4bAAAAEXRFWHRTb2Z0d2FyZQBTbmlwYXN0ZV0Xzt0AAAEKSURBVGiB7dvRaoMwGEDhP3Hv/4I+hPei/rs5Slo2lw1KITsHSi0m0X54acpxHBkRUUqJiIjMvI6fuzv3fD4zo123Z87dmLOvxvZe625s/XHmP0kIEoKEICFICBKChCAhSAgSgoQgIUgIEoKEICFICBKChCAhSAgSgoQgIUgIEoKEICFICBKChCAhSAgSgoQgIUgIEoKEICFICBKChKChINqX13/bUBDtG/cnSi/OUBCZGeu6xrZtDwA9GMNBzPMcy7Jcv9vvu8pIG1cy81rv/Hw3duiNK7XWqPXxL+373jf3FTf07k6MzIxpmrrmfLzyht7R+cj37O9qG/KJ+EtCkBAkBAlBQpAQ9AkRmWqufm0+xwAAAABJRU5ErkJggg==",
"scale" : "0.022",
"locatedDeviceList" : [
{
"id" : "c2b378d8-145f-4e46-8d71-c3709695dd06",
"name" : "AP6605",
"status" : "0",
"deviceType" : "",
"positionX" : "32",
"positionY" : "32",
"planPositionX" : "32",
"planPositionY" : "32"
}
],
"unLocatedDeviceList" : [
{
"id" : "c2b378d8-145f-4e46-8d71-c3709695dd06",
"name" : "AP6605",
"status" : "0",
"deviceType" : ""
}
]
}
} 返回状态码为400:请求参数错误,无响应体。 HTTP/1.1 400 Bad Request
Date: Sun,11 May 2025 10:00:00 GMT
Server: example-server
Content-Type: application/json;charset=UTF-8
Content-Length: 250
Connection: keep-alive
返回状态码为500:内部服务器错误,无响应体。 HTTP/1.1 500 Internal Server Error
Date: Sun,11 May 2025 10:00:00 GMT
Server: example-server
Content-Type: application/json;charset=UTF-8
Content-Length: 250
Connection: keep-alive
-
响应参数 返回状态码为200:查询成功,响应体参考QueryFloorLocationDetailsResponse。 表2 QueryFloorLocationDetailsResponse对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errcode string - - 错误码。 "0" errmsg string - - 错误信息。 "error" data REFERENCE 详细请参见表3。 楼层布放信息模型 - 表3 FloorLocationDetails对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 name string - - 楼层名称。 "F3" buildingName string - - 楼层所属楼栋名称。 "N1" image byte - - 楼层图纸。 "iVBORw0KGgoAAAANSUhEUgAAAEIAAAA8CAYAAADSfGxZAAAACXBIWXMAAA7EAAAOxAGVKw4bAAAAEXRFWHRTb2Z0d2FyZQBTbmlwYXN0ZV0Xzt0AAAEKSURBVGiB7dvRaoMwGEDhP3Hv/4I+hPei/rs5Slo2lw1KITsHSi0m0X54acpxHBkRUUqJiIjMvI6fuzv3fD4zo123Z87dmLOvxvZe625s/XHmP0kIEoKEICFICBKChCAhSAgSgoQgIUgIEoKEICFICBKChCAhSAgSgoQgIUgIEoKEICFICBKChCAhSAgSgoQgIUgIEoKEICFICBKChKChINqX13/bUBDtG/cnSi/OUBCZGeu6xrZtDwA9GMNBzPMcy7Jcv9vvu8pIG1cy81rv/Hw3duiNK7XWqPXxL+373jf3FTf07k6MzIxpmrrmfLzyht7R+cj37O9qG/KJ+EtCkBAkBAlBQpAQ9AkRmWqufm0+xwAAAABJRU5ErkJggg==" scale double - - 比例尺,表示图上距离与实际距离的比,例如:图上0.01米代表实际1米,则比例尺为0.01。 "0.022" locatedDeviceList ARRAY_REFERENCE 0-2147483647个列表项,详细请参见表4。 已布放设备列表。 - unLocatedDeviceList ARRAY_REFERENCE 0-2147483647个列表项,详细请参见表5。 未布放设备列表。 - 表4 LocatedDeviceInfo对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 id string - - 设备ID,格式UUID。 "c2b378d8-145f-4e46-8d71-c3709695dd06" name string - - 设备名称。 "AP6605" status string 0 1 3 4 - 设备状态 0: 正常 1: 告警 3: 离线 4: 未注册 "0" deviceType string AP AR FW LSW AC OLT ONT - 设备类型 "AP" - 接入点 "AR" - 接入路由器 "FW" - 防火墙 "LSW" - 交换机 "AC" - 接入控制器 "OLT" - 光线路终端 "ONT" - 光网络终端 - positionX int32 - - 设备布放坐标X,单位:像素。 "32" positionY int32 - - 设备布放坐标Y,单位:像素。 "32" planPositionX int32 - - 设备规划坐标X,单位:像素。 "32" planPositionY int32 - - 设备规划坐标Y,单位:像素。 "32" 表5 DeviceInfo对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 id string - - 设备ID,格式UUID。 "c2b378d8-145f-4e46-8d71-c3709695dd06" name string - - 设备名称。 "AP6605" status string 0 1 3 4 - 设备状态 0: 正常 1: 告警 3: 离线 4: 未注册 "0" deviceType string AP AR FW LSW AC OLT ONT - 设备类型 "AP" - 接入点 "AR" - 接入路由器 "FW" - 防火墙 "LSW" - 交换机 "AC" - 接入控制器 "OLT" - 光线路终端 "ONT" - 光网络终端 - 返回状态码为400:请求参数错误,无响应体。 详细信息请参见实际响应消息体。 返回状态码为500:内部服务器错误,无响应体。 详细信息请参见实际响应消息体。
-
请求示例 HTTP的示例 GET /controller/campus/v1/indoormapservice/floors/75ade72a-e7a9-4c81-8fca-894e7ca9c2c2/locaion-details HTTP/1.1
Host: 192.168.1.125:18002
Content-Type: application/json
Accept: application/json
Accept-Language: en-US
X-ACCESS-TOKEN: x-yyyyyy