学生请假信息

当前版本:

    version= V1.0

接口功能:

    用于分页获取RunLan平台学生请假信息。

接口地址:

    /api/v1/student/queryLeaves

请求方式:

    POST

请求参数:

Body

参数名称是否必选参数类型说明/示例
selTypeInt查询类型 0:分页查询,1:列表查询
pageSize条件必选(当selType=0时必选,下同)Int查询条数(建议设置为1~300)
page条件必选Int当前页数(从1开始)
studentIDString学生ID
classIDString班级ID
departmentIDString教学单位ID
leaveTypeString请假类型(ID)
startTimeString请假开始时间:yyyy-MM-dd(范围查找,下同)
endTimeString请假结束时间:yyyy-MM-dd
passStartTimeString起始请假审批通过时间 yyyy-MM-dd HH:mm:ss(范围查询)
passEndTimeString结束请假审批通过时间 yyyy-MM-dd HH:mm:ss(范围查询)

说明:1.为了保证系统的效率,建议每次分页取数据最多不超过300条数据 ;当查询列表时,开始时间/审批通过开始时间 和 结束时间/审批通过结束时间不宜为空,且范围不宜超过一周。

返回值说明

返回值字段类型说明
msgString提示信息
codeString200成功,其他为失败
dataObject学生请假信息分页结果集

result结果集返回值字段说明


返回值字段类型说明
totalInt总条数
currentInt当前页
sizeInt每页条数
rowsArray当前分页学生请假信息数据集
dataObject学生请假信息(当数据为空时为data:[])
objectIDString请假记录ID(非空)
studentIDString学生ID
studentNameString姓名
classIDString班级ID
classNameString班级名称
departmentIDString教学单位ID
departmentNameString教学单位名称
startTimeString请假开始时间 yyyy-MM-dd HH:mm:ss
endTimeString请假结束时间 yyyy-MM-dd HH:mm:ss
idCardNumberString证件号码,如身份证号码、护照号等
passTimeString请假审批通过时间 yyyy-MM-dd HH:mm:ss
leaveReasonString请假原因
checkStateInt审核状态 0待审核 1审核中 2通过 -1未通过
isErminationInt销假状态0未销假1已销假
erminationTimeString销假时间,格式:yyyy-MM-dd HH:mm:ss
leaveType
String请假类型(ID)
leaveTypeNameString请假类型名称
isOutStateInt出校状态 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

  }

版本变更说明:

    无