国资房产
建筑信息
描述
建筑信息
支持的模式
- client_credentials
请求方法
GET
请求地址
https://api.ecnu.edu.cn/api/v1/asset/buildings
请求参数
参数名 | 是否必填 | 备注 |
---|---|---|
pageNum | 是 | 分页第几页,从1开始 |
pageSize | 是 | 每页的数量 |
返回参数
参数名 | 类型 | 备注 |
---|---|---|
totalNum | number | 总共的条目数 |
pageSize | number | 每页的大小 |
rows | object array | 具体的返回 |
buildingId | string | 建筑物编号 |
buildingName | string | 建筑物名称 |
siteName | string | 校区名称 |
请求示例
curl -i -H "Authorization: Bearer e447e4b4b8e23973b42c44b8d5415603" "https://api.ecnu.edu.cn/api/v1/asset/buildings?pageNum=1&pageSize=5"
返回示例
json
{
"data": {
"totalNum": 245,
"pageSize": 5,
"rows": [
{
"buildingName": "****大楼",
"siteName": "普陀校区",
"buildingId": "1"
},
{
"buildingName": "****大楼",
"siteName": "普陀校区",
"buildingId": "100"
},
{
"buildingName": "****大楼",
"siteName": "普陀校区",
"buildingId": "11"
},
{
"buildingName": "****大楼",
"siteName": "普陀校区",
"buildingId": "110"
},
{
"buildingName": "****大楼",
"siteName": "普陀校区",
"buildingId": "113"
}
],
"pageNum": 1
},
"errCode": 0,
"requestId": "6a0f0e4b16251931256192991e5280",
"errMsg": "success",
"apiLog": null
}
房间详细信息
描述
房间详细信息
支持的模式
- client_credentials
请求方法
GET
请求地址
https://api.ecnu.edu.cn/api/v1/asset/room/detail
请求参数
参数名 | 是否必填 | 备注 |
---|---|---|
roomUUID | 是 | 房间编码 |
返回参数
参数名 | 类型 | 备注 |
---|---|---|
roomUUID | string | 房间唯一编码 |
buildingId | string | 建筑物编码 |
buildingName | string | 建筑物名称 |
siteName | string | 校区名称 |
floor | string | 楼层 |
roomId | string | 房间号 |
buildingArea | number | 建筑面积,单位:M2 |
usableArea | number | 使用面积,单位:M2 |
dvId | string | 单位编码 |
dvName | string | 使用单位 |
dpId | string | 部门编码 |
dpName | string | 部门名称 |
dvManage | string | 管理部门 |
roomType | string | 类别代码 |
roomTypeName | string | 类别名称 |
roomCatType | string | 类型代码 |
roomCatName | string | 类型名称 |
roomUseType | string | 大类代码 |
roomUseName | string | 大类名称 |
roomName | string | 房间名称 |
roomUserCount | int | 教职工人数 |
请求示例
curl -i -H "Authorization: Bearer e447e4b4b8e23973b42c44b8d5415603" "https://api.ecnu.edu.cn/api/v1/asset/room/detail?roomUUID=129_F04_421"
返回示例
json
{
"data": [
{
"dvId": "***",
"dpName": "",
"roomUseType": "30",
"dpId": "",
"roomUseName": "生活用房",
"roomTypeName": "学生居室",
"buildingArea": 1,
"siteName": "普陀校区",
"roomCatName": "学生宿舍",
"roomId": "***",
"roomName": "***",
"buildingId": "129",
"buildingName": "***",
"dvManage": "***",
"dvName": "宿舍",
"usableArea": 1,
"roomUserCount": 0,
"roomCatType": "***",
"floor": "F04",
"roomUUID": "***",
"roomType": "***"
}
],
"requestId": "6a0f0ef016251937292311292e05d1",
"errCode": 0,
"errMsg": "success",
"apiLog": null
}
根据使用人查询房间信息
描述
根据使用人查询房间信息
支持的模式
- authorization_code
- client_credentials
- password
请求方法
GET
请求地址
https://api.ecnu.edu.cn/api/v1/asset/room/user
请求参数
参数名 | 是否必填 | 备注 |
---|---|---|
userId | 是 | 学工号,当授权为authorization_code和password模式时可省略 |
返回参数
参数名 | 类型 | 备注 |
---|---|---|
roomUUID | string | 房间唯一编码 |
buildingId | string | 建筑物编码 |
buildingName | string | 建筑物名称 |
siteName | string | 校区名称 |
floor | string | 楼层 |
roomId | string | 房间号 |
roomName | string | 房间名称 |
buildingArea | number | 建筑面积,单位:M2 |
usableArea | number | 使用面积,单位:M2 |
roomUserCount | int | 教职工人数 |
请求示例
curl -i -H "Authorization: Bearer e447e4b4b8e23973b42c44b8d5415603" "https://api.ecnu.edu.cn/api/v1/asset/room/user?userId=201****7"
返回示例
json
{
"data": [
{
"buildingName": "****",
"usableArea": 1,
"siteName": "闵行校区",
"buildingArea": 1,
"roomUserCount": 5,
"floor": "***",
"roomUUID": "****",
"roomId": "***",
"roomName": "***",
"buildingId": "***"
}
],
"errCode": 0,
"requestId": "65841f9216252046320577924e7bbe",
"errMsg": "success",
"apiLog": null
}
根据建筑查询房间信息
描述
根据建筑查询房间信息
支持的模式
- client_credentials
请求方法
GET
请求地址
https://api.ecnu.edu.cn/api/v1/asset/room/building
请求参数
参数名 | 是否必填 | 备注 |
---|---|---|
pageNum | 是 | 分页第几页,从1开始 |
pageSize | 是 | 每页的数量 |
buildingId | 是 | 建筑物编码 |
roomCatType | 否 | 房间类型编码(若不填则返回所有) |
返回参数
参数名 | 类型 | 备注 |
---|---|---|
totalNum | number | 总共的条目数 |
pageSize | number | 每页的大小 |
rows | object array | 具体的返回 |
buildingId | string | 建筑物编号 |
buildingName | string | 建筑物名称 |
siteName | string | 校区名称 |
roomUUID | string | 房间唯一编码 |
floor | string | 楼层 |
roomId | string | 房间号 |
roomName | string | 房间名称 |
roomCatType | string | 房间类型编码 |
roomCatName | string | 房间类型名称 |
请求示例
curl -i -H "Authorization: Bearer e447e4b4b8e23973b42c44b8d5415603" "https://api.ecnu.edu.cn/api/v1/asset/room/building?pageSize=2&pageNum=1&buildingId=1029"
返回示例
json
{
"data": {
"totalNum": 5,
"pageSize": 10,
"rows": [
{
"buildingName": "****",
"siteName": "闵行校区",
"roomCatType": "303",
"floor": "F01",
"roomUUID": "1001****",
"roomCatName": "****用房",
"roomId": "101",
"roomName": "****活动室",
"buildingId": "1001"
},
{
"buildingName": "****",
"siteName": "闵行校区",
"roomCatType": "303",
"floor": "F01",
"roomUUID": "1001****",
"roomCatName": "****用房",
"roomId": "101",
"roomName": "****活动室",
"buildingId": "1001"
},
{
"buildingName": "****",
"siteName": "闵行校区",
"roomCatType": "303",
"floor": "F01",
"roomUUID": "1001****",
"roomCatName": "****用房",
"roomId": "101",
"roomName": "****活动室",
"buildingId": "1001"
},
{
"buildingName": "****",
"siteName": "闵行校区",
"roomCatType": "303",
"floor": "F01",
"roomUUID": "1001****",
"roomCatName": "****用房",
"roomId": "101",
"roomName": "****活动室",
"buildingId": "1001"
},
{
"buildingName": "****",
"siteName": "闵行校区",
"roomCatType": "303",
"floor": "F01",
"roomUUID": "1001****",
"roomCatName": "****用房",
"roomId": "101",
"roomName": "****活动室",
"buildingId": "1001"
},
],
"pageNum": 1
},
"errCode": 0,
"requestId": "0bc1742116488070513461537e4847",
"errMsg": "success"
}
根据建筑查询房间与房门信息
描述
根据建筑查询房间与房门的信息
支持的模式
- client_credentials
请求方法
GET
请求地址
https://api.ecnu.edu.cn/api/v1/asset/door/building
请求参数
参数名 | 是否必填 | 备注 |
---|---|---|
pageNum | 是 | 分页第几页,从1开始 |
pageSize | 是 | 每页的数量 |
buildingId | 是 | 建筑物编码 |
返回参数
参数名 | 类型 | 备注 |
---|---|---|
totalNum | number | 总共的条目数 |
pageSize | number | 每页的大小 |
rows | object array | 具体的返回 |
siteName | string | 校区名称 |
buildingId | string | 建筑物编号 |
buildingName | string | 建筑物名称 |
floor | string | 楼层 |
doorUUID | string | 房门唯一编码 |
doorId | string | 房门号 |
doorName | string | 房门名称 |
dwgName | string | 图纸名称 |
roomUUID | string | 房间唯一编码,如果无关联房间则为空字符串 |
roomId | string | 房间号,如果无关联房间则为空字符串 |
roomName | string | 房间名称,如果无关联房间则为空字符串 |
roomCatType | string | 房间类型编码,如果无关联房间则为空字符串 |
roomCatName | string | 房间类型名称,如果无关联房间则为空字符串 |
请求示例
curl -i -H "Authorization: Bearer e447e4b4b8e23973b42c44b8d5415603" "https://api.ecnu.edu.cn/api/v1/asset/door/building?pageSize=2&pageNum=1&buildingId=160"
返回示例
json
{
"data": {
"totalNum": 1081,
"pageSize": 2,
"rows": [{
"siteName": "普陀校区",
"buildingId": "160",
"buildingName": "****大楼",
"floorId": "F20",
"doorUUID": "01_******",
"doorId": "**2B",
"doorName": "**2B",
"dwgName": "160-F20",
"roomUUID": "01_**",
"roomId": "**2B",
"roomCatType": "SERV",
"roomCatName": "SERV",
"roomName": "水箱间"
},{
"siteName": "普陀校区",
"buildingId": "160",
"buildingName": "****大楼",
"floorId": "F20",
"doorUUID": "01_******",
"doorId": "**2B",
"doorName": "**2B",
"dwgName": "160-F20",
"roomUUID": "01_**",
"roomId": "**2B",
"roomCatType": "SERV",
"roomCatName": "SERV",
"roomName": "水箱间"
}],
"pageNum": 1
},
"errCode": 0,
"requestId": "D6C7332D-EC16-4692-8BC4-D6FCE0C1DA73",
"errMsg": "success",
"apiLog": null
}
根据房间号查使用人工号
描述
根据房间号查使用人工号
支持的模式
- client_credentials
请求方法
GET
请求地址
https://api.ecnu.edu.cn/api/v1/asset/roomuser
请求参数
参数名 | 是否必填 | 备注 |
---|---|---|
roomUUID | 是 | 房间编码 |
返回参数
参数名 | 类型 | 备注 |
---|---|---|
userId | string | 使用人工号 |
roomUUID | string | 房间唯一编码 |
请求示例
curl -i -H "Authorization: Bearer e447e4b4b8e23973b42c44b8d5415603" "https://api.ecnu.edu.cn/api/v1/asset/roomuser?roomUUID=1029_****"
返回示例
json
{
"data": [
{
"userId": "20*****0",
"roomUUID": "1029_*****"
},
{
"userId": "20*****0",
"roomUUID": "1029_*****"
}
],
"errCode": 0,
"requestId": "65841f9216252059301317078e7bbb",
"errMsg": "success",
"apiLog": null
}
全量同步所有的房间与房门信息
描述
全量同步所有的房间与房门信息
支持的模式
- client_credentials
请求方法
GET
请求地址
https://api.ecnu.edu.cn/api/v1/asset/roomdoors
请求参数
参数名 | 是否必填 | 备注 |
---|---|---|
pageNum | 是 | 分页第几页,从1开始 |
pageSize | 是 | 每页的数量 |
返回参数
参数名 | 类型 | 备注 |
---|---|---|
totalNum | number | 总共的条目数 |
pageSize | number | 每页的大小 |
rows | object array | 具体的返回 |
siteName | string | 校区名称 |
buildingId | string | 建筑物编号 |
buildingName | string | 建筑物名称 |
floor | string | 楼层 |
doorUUID | string | 房门唯一编码 |
doorId | string | 房门号 |
roomId | string | 房间号 |
buildingArea | number | 房间的建筑面积,单位:M2 |
usableArea | number | 房间的使用面积,单位:M2 |
dvId | string | 房间的单位编码 |
dvName | string | 房间的使用单位 |
dpId | string | 房间的部门编码 |
dpName | string | 房间的部门名称 |
dvManage | string | 房间的管理部门 |
roomType | string | 房间的类别代码 |
roomTypeName | string | 房间的类别名称 |
roomCatType | string | 房间的类型代码 |
roomCatName | string | 房间的类型名称 |
roomUseType | string | 房间的大类代码 |
roomUseName | string | 房间的大类名称 |
roomName | string | 房间名称 |
请求示例
curl -i -H "Authorization: Bearer e447e4b4b8e23973b42c44b8d5415603" "https://api.ecnu.edu.cn/api/v1/asset/roomdoors?pageSize=1&pageNum=1"
返回示例
json
{
"data": {
"totalNum": 83440,
"pageSize": 1,
"rows": [{
"siteName": "普陀校区",
"buildingId": "1",
"buildingName": "****",
"floor": "F01",
"doorUUID": "01_****",
"doorId": "101",
"roomId": "101",
"buildingArea": 28.67,
"usableArea": 28.67,
"dvId": "****",
"dvName": "****",
"dpId": "****",
"dpName": "****",
"dvManage": "****",
"roomType": "****",
"roomTypeName": "****",
"roomCatType": "****",
"roomCatName": "****",
"roomUseType": "****",
"roomUseName": "****",
"roomName": "****"
}],
"pageNum": 1
},
"errCode": 0,
"requestId": "621FBD89-69F7-40C1-803C-4F66E5AED213",
"errMsg": "success"
}