当前版本:
version= V1.0
接口功能:
用于分页获取RunLan平台宿舍楼信息。
接口地址:
/api/v1/dormitory/queryDormitorys
请求方式:
POST
请求参数:
Body
| 参数名称 | 是否必选 | 类型 | 说明/示例 |
|---|---|---|---|
| selType | 是 | Int | 查询方式 0:分页查询,1:查询列表 |
| page | 条件必选(当selType=0时必选,下同) | Int | 页码 |
| pageSize | 条件必选 | Int | 每页大小 |
| sex | 否 | Int | 入住性别 0女1男2混合 |
| dormitoryID | 否 | String | 宿舍楼ID |
| isDelete | 否 | Int | 删除状态 0未删除1已删除 |
返回值说明
| 返回值字段 | 类型 | 说明 |
|---|---|---|
| msg | String | 提示信息 |
| code | Int | 200成功,其它失败 |
| data | Object | 部门信息分页结果集 |
result结果集返回值字段说明
| 返回值字段 | 类型 | 说明 |
|---|---|---|
| total | Int | 总条数 |
| current | Int | 当前页 |
| size | Int | 每页条数 |
| rows | Array | 当前分页部门信息数据集 |
| data | Object | 宿舍楼信息(当数据为空时为data:[]) |
| dormitoryID | String | 宿舍楼ID |
| dormitoryName | String | 宿舍楼名称 |
| totalFloors | Int | 楼层数 |
| totalRooms | Int | 房间数 |
| perBeds | Int | 每个房间床位数 |
| sex | Int | 入住性别:0女1男2混合 |
| remark | String | 备注 |
| dormitoryManagers | String | 宿舍管理员ID(多个用 , 隔开) |
| dormitoryManagerNames | String | 宿舍管理员姓名(多个用 , 隔开) |
| lifeTeachers | String | 生活指导老师ID(多个用 , 隔开) |
| lifeTeacherNames | String | 生活指导老师姓名(多个用 , 隔开) |
| isDelete | Int | 删除状态 0未删除1已删除 |
返回结果示例(JSON)
返回成功
分页查询
{
"success": true,
"code": 200,
"msg": "成功",
"data": {
"total": 5,
"current": 1,
"size": 2,
"rows": [
{
"dormitoryID": "1846389E-65D9-6D1A-94E4-B2DE21EF6345",
"dormitoryName": "学生公寓1号楼",
"totalFloors": 3,
"totalRooms": 20,
"perBeds": 4,
"sex": 1,
"remark": "",
"dormitoryManagers": "A469A78D-168B-CA17-D2C2-D77F904CFBD9,C1C1EB32-8B62-2508-4E73-33333D19D7A0",
"lifeTeachers": null,
"dormitoryManagerNames": "李团结,陈平安",
"lifeTeacherNames": null,
"isDelete": 0
},
{
"dormitoryID": "202C0E7D-2450-9673-82E6-04C5681B8EF0",
"dormitoryName": "学生公寓2号楼",
"totalFloors": 3,
"totalRooms": 20,
"perBeds": 4,
"sex": 1,
"remark": "",
"dormitoryManagers": null,
"lifeTeachers": null,
"dormitoryManagerNames": null,
"lifeTeacherNames": null,
"isDelete": 0
}
]
}
}
列表查询
{
"success": true,
"code": 200,
"msg": "成功",
"data": [
{
"dormitoryID": "08893EE8-98B2-DAC3-DAFA-C13228A8C6D2",
"dormitoryName": "八号楼",
"totalFloors": 3,
"totalRooms": 16,
"perBeds": 8,
"sex": 0,
"remark": "",
"dormitoryManagers": null,
"lifeTeachers": null,
"dormitoryManagerNames": null,
"lifeTeacherNames": null,
"isDelete": 0
},
{
"dormitoryID": "F72F4B9A-AE13-EE63-462C-B46B739D19B1",
"dormitoryName": "七号楼",
"totalFloors": 3,
"totalRooms": 15,
"perBeds": 8,
"sex": 0,
"remark": "",
"dormitoryManagers": null,
"lifeTeachers": null,
"dormitoryManagerNames": null,
"lifeTeacherNames": null,
"isDelete": 0
}
]
}
返回失败
{
"msg":"具体错误原因",
"code":-999
}
版本变更说明:
无