学生住宿信息
当前版本：
version= V1.0
接口功能：
用于分页获取RunLan平台学生住宿信息。
接口地址：
/api/v1/student/queryBeds
请求方式：
POST
请求参数：
Body
| 参数名称 | 是否必选 | 参数类型 | 说明/示例 |
|---|---|---|---|
| selType | 是 | Int | 查询类型 0:分页查询,1:列表查询 |
| pageSize | 条件必选（当selType=0时必选，下同 | Int | 查询条数(建议设置为1~300) |
| page | 条件必选 | Int | 当前页数(从1开始) |
| isDelete | 否 | Int | 删除状态 0未删除1已删除 |
| assignStartTime | 否 | Int | 起始分配时间 yyyy-MM-dd HH:mm:ss（范围查询） |
说明：为了保证系统的效率，建议每次取数据最多不超过300条数据。
返回值说明
| 返回值字段 | 类型 | 说明 |
|---|---|---|
| msg | String | 提示信息 |
| code | String | 200成功，其他失败 |
| data | Object | 学生住宿信息结果集 |
result结果集返回值字段说明
| 返回值字段 | 类型 | 说明 |
|---|---|---|
| total | Int | 总条数 |
| current | Int | 当前页 |
| size | Int | 每页条数 |
| rows | Array | 当前分页学生住宿信息数据集 |
| data | Object | 学生住宿信息(当数据为空时为data:[]) |
| studentID | String | 学生ID（非空） |
| studentName | String | 姓名 |
| studentSex | String | 性别 0女1男 |
| idCardNumber | String | 证件号码，如身份证号码、护照号等 |
| bedID | String | 床位ID |
| dormitoryID | String | 宿舍楼ID |
| dormitoryName | String | 宿舍楼名称 |
| floorID | String | 楼层ID |
| floorIndex | Int | 楼层号 |
| roomID | String | 房间ID |
| roomCode | String | 房间号 |
| bedCode | String | 床位号 |
| isAbove | Int | 上下铺0下铺1上铺 |
| classID | String | 班级ID |
| assignTime | String | 分配时间，格式：yyyy-MM-dd HH:mm:ss |
返回结果示例(JSON)
返回成功
分页查询
{
"success": true,
"code": 200,
"msg": "成功",
"data": {
"total": 481,
"current": 1,
"size": 2,
"rows": [
{
"studentID": "0049781b-2768-46dc-8f9f-7f796d4fc404",
"studentName": "夏子寒",
"studentSex": "1",
"bedID": "08E08200-85D2-F997-5C8C-31C534D95CE2",
"dormitoryID": "1846389E-65D9-6D1A-94E4-B2DE21EF6345",
"dormitoryName": "学生公寓1号楼",
"floorID": "CB240988-8FA2-B413-B582-EA39B0A1A9B8",
"floorIndex": 1,
"roomID": "D69CC524-0B6A-706D-ADB5-78DD60751126",
"roomCode": "01017",
"bedCode": "4",
"isAbove": 1,
"classID": "72412fad-d8d6-4ced-8067-5ef1e5931dd2",
"idCardNumber": "341282200611220178",
"assignTime": "2025-06-11 14:10:53"
},
{
"studentID": "0076de06-7242-442e-bd72-8777edf199af",
"studentName": "黄瑞",
"studentSex": "1",
"bedID": "115C310C-A0D8-B21B-A939-1004F26493FC",
"dormitoryID": "202C0E7D-2450-9673-82E6-04C5681B8EF0",
"dormitoryName": "学生公寓2号楼",
"floorID": "11B33BC1-CE42-1E69-786D-B54D9AC54543",
"floorIndex": 1,
"roomID": "5CCE2303-A55C-5942-C9C2-7A173EDE4A13",
"roomCode": "01015",
"bedCode": "2",
"isAbove": 1,
"classID": "4ca38d87-f20b-42c5-afe2-fb3ff76fd487",
"idCardNumber": "341022200412261519",
"assignTime": "2025-06-11 14:10:53"
}
]
}
}
列表查询
{
"success": true,
"code": 200,
"msg": "成功",
"data": [
{
"studentID": "0049781b-2768-46dc-8f9f-7f796d4fc404",
"studentName": "夏子寒",
"studentSex": "1",
"bedID": "08E08200-85D2-F997-5C8C-31C534D95CE2",
"dormitoryID": "1846389E-65D9-6D1A-94E4-B2DE21EF6345",
"dormitoryName": "学生公寓1号楼",
"floorID": "CB240988-8FA2-B413-B582-EA39B0A1A9B8",
"floorIndex": 1,
"roomID": "D69CC524-0B6A-706D-ADB5-78DD60751126",
"roomCode": "01017",
"bedCode": "4",
"isAbove": 1,
"classID": "72412fad-d8d6-4ced-8067-5ef1e5931dd2",
"idCardNumber": "341282200611220178",
"assignTime": "2025-06-11 14:10:53"
},
{
"studentID": "0076de06-7242-442e-bd72-8777edf199af",
"studentName": "黄瑞",
"studentSex": "1",
"bedID": "115C310C-A0D8-B21B-A939-1004F26493FC",
"dormitoryID": "202C0E7D-2450-9673-82E6-04C5681B8EF0",
"dormitoryName": "学生公寓2号楼",
"floorID": "11B33BC1-CE42-1E69-786D-B54D9AC54543",
"floorIndex": 1,
"roomID": "5CCE2303-A55C-5942-C9C2-7A173EDE4A13",
"roomCode": "01015",
"bedCode": "2",
"isAbove": 1,
"classID": "4ca38d87-f20b-42c5-afe2-fb3ff76fd487",
"idCardNumber": "341022200412261519",
"assignTime": "2025-06-11 14:10:53"
}
]
}
返回失败
{
"msg":"详细错误原因",
"code":-999
}
版本变更说明：
无