当前版本:
version= V1.0
接口功能:
用于分页获取RunLan平台学生请假信息。
接口地址:
/api/v1/student/queryLeaves
请求方式:
POST
请求参数:
Body
| 参数名称 | 是否必选 | 参数类型 | 说明/示例 |
|---|---|---|---|
| selType | 是 | Int | 查询类型 0:分页查询,1:列表查询 |
| pageSize | 条件必选(当selType=0时必选,下同) | Int | 查询条数(建议设置为1~300) |
| page | 条件必选 | Int | 当前页数(从1开始) |
| studentID | 否 | String | 学生ID |
| classID | 否 | String | 班级ID |
| departmentID | 否 | String | 教学单位ID |
| leaveType | 否 | String | 请假类型(ID) |
| startTime | 否 | String | 请假开始时间:yyyy-MM-dd(范围查找,下同) |
| endTime | 否 | String | 请假结束时间:yyyy-MM-dd |
| passStartTime | 否 | String | 起始请假审批通过时间 yyyy-MM-dd HH:mm:ss(范围查询) |
| passEndTime | 否 | String | 结束请假审批通过时间 yyyy-MM-dd HH:mm:ss(范围查询) |
说明:1.为了保证系统的效率,建议每次分页取数据最多不超过300条数据 ;当查询列表时,开始时间/审批通过开始时间 和 结束时间/审批通过结束时间不宜为空,且范围不宜超过一周。
返回值说明
| 返回值字段 | 类型 | 说明 |
|---|---|---|
| msg | String | 提示信息 |
| code | String | 200成功,其他为失败 |
| data | Object | 学生请假信息分页结果集 |
result结果集返回值字段说明
| 返回值字段 | 类型 | 说明 |
|---|---|---|
| total | Int | 总条数 |
| current | Int | 当前页 |
| size | Int | 每页条数 |
| rows | Array | 当前分页学生请假信息数据集 |
| data | Object | 学生请假信息(当数据为空时为data:[]) |
| objectID | String | 请假记录ID(非空) |
| studentID | String | 学生ID |
| studentName | String | 姓名 |
| classID | String | 班级ID |
| className | String | 班级名称 |
| departmentID | String | 教学单位ID |
| departmentName | String | 教学单位名称 |
| startTime | String | 请假开始时间 yyyy-MM-dd HH:mm:ss |
| endTime | String | 请假结束时间 yyyy-MM-dd HH:mm:ss |
| idCardNumber | String | 证件号码,如身份证号码、护照号等 |
| passTime | String | 请假审批通过时间 yyyy-MM-dd HH:mm:ss |
| leaveReason | String | 请假原因 |
| checkState | Int | 审核状态 0待审核 1审核中 2通过 -1未通过 |
| isErmination | Int | 销假状态0未销假1已销假 |
| erminationTime | String | 销假时间,格式:yyyy-MM-dd HH:mm:ss |
| leaveType | String | 请假类型(ID) |
| leaveTypeName | String | 请假类型名称 |
| isOutState | Int | 出校状态 0未出校 1、2、3...每次出校加1 |
返回结果示例(JSON)
返回成功
分页查询
{
"success": true,
"code": 200,
"msg": "成功",
"data": {
"total": 15399,
"current": 1,
"size": 2,
"rows": [
{
"objectID": "AF49BDB6-B2DD-1332-E74E-8690F5ACF956",
"studentID": "8c8dc26c-a780-4d62-853c-4c194dcdb5cc",
"studentName": "秦道明",
"classID": "2552a91a-2fc9-4d8f-8114-b1dee84be39e",
"className": "2023级建筑工程造价3+2(2)班",
"departmentID": "539c5691-ace6-40dc-aba3-34c567a8051f",
"departmentName": "城市管理系",
"startTime": "2025-04-26 00:00:00",
"endTime": "2025-04-26 00:00:00",
"leaveType": "186DD00D-AF2B-9F7C-FA39-903FBAF63D2B",
"leaveTypeName": "病假",
"idCardNumber": "341503200806114317",
"leaveReason": "腿疼",
"passTime": "2025-04-26 08:54:30",
"erminationTime": null,
"checkState": 2,
"isErmination": 0,
"isOutState": 0
},
{
"objectID": "BA1DB23E-4C14-49C8-F365-DB9C2F68B822",
"studentID": "0d7e260f-16b0-4ba6-b64d-112e09a1626c",
"studentName": "王婷婷",
"classID": "fa03de4e-006a-4e20-acdd-f4b39ce4a2ef",
"className": "2024级计算机平面设计3+2水湖(2)班",
"departmentID": "dcee37f9-8ceb-4fae-a8ae-65c365ddfbcb",
"departmentName": "信息技术系",
"startTime": "2025-04-26 01:01:00",
"endTime": "2025-04-26 19:10:00",
"leaveType": "89B72A3A-870D-20F8-7C5A-79EAFB25047E",
"leaveTypeName": "事假",
"idCardNumber": "340621200805081266",
"leaveReason": "回家",
"passTime": "2025-04-26 13:50:15",
"erminationTime": null,
"checkState": 2,
"isErmination": 0,
"isOutState": 0
}
]
}
}
列表查询
{
"success": true,
"code": 200,
"msg": "成功",
"data": [
{
"objectID": "AF49BDB6-B2DD-1332-E74E-8690F5ACF956",
"studentID": "8c8dc26c-a780-4d62-853c-4c194dcdb5cc",
"studentName": "秦道明",
"classID": "2552a91a-2fc9-4d8f-8114-b1dee84be39e",
"className": "2023级建筑工程造价3+2(2)班",
"departmentID": "539c5691-ace6-40dc-aba3-34c567a8051f",
"departmentName": "城市管理系",
"startTime": "2025-04-26 00:00:00",
"endTime": "2025-04-26 00:00:00",
"leaveType": "186DD00D-AF2B-9F7C-FA39-903FBAF63D2B",
"leaveTypeName": "病假",
"idCardNumber": "341503200806114317",
"leaveReason": "腿疼",
"passTime": "2025-04-26 08:54:30",
"erminationTime": null,
"checkState": 2,
"isErmination": 0,
"isOutState": 0
},
{
"objectID": "BA1DB23E-4C14-49C8-F365-DB9C2F68B822",
"studentID": "0d7e260f-16b0-4ba6-b64d-112e09a1626c",
"studentName": "王婷婷",
"classID": "fa03de4e-006a-4e20-acdd-f4b39ce4a2ef",
"className": "2024级计算机平面设计3+2水湖(2)班",
"departmentID": "dcee37f9-8ceb-4fae-a8ae-65c365ddfbcb",
"departmentName": "信息技术系",
"startTime": "2025-04-26 01:01:00",
"endTime": "2025-04-26 19:10:00",
"leaveType": "89B72A3A-870D-20F8-7C5A-79EAFB25047E",
"leaveTypeName": "事假",
"idCardNumber": "340621200805081266",
"leaveReason": "回家",
"passTime": "2025-04-26 13:50:15",
"erminationTime": null,
"checkState": 2,
"isErmination": 0,
"isOutState": 0
}
]
}
返回失败
{
"msg":"详细错误原因",
"code":-999
}
版本变更说明:
无