班级信息

当前版本：

    version= V1.0

接口功能：

    用于分页获取RunLan平台班级信息。

接口地址：

    /api/v1/class/queryClassList

请求方式：

    POST

请求参数：

    Body

参数名称	是否必选	类型	说明/示例
selType	是	Int	查询类型 0:分页查询,1:列表查询
page	条件必选：(当selType=0时必选，下同)	Int	页码
pageSize	条件必选	Int	单页大小
classID	否	String	班级ID
className	否	String	班级名称
classCode	否	String	班级代码
departmentID	否	String	教学单位ID
specialtyID	否	String	专业ID
startTime	否	String	开班日期 yyyy-MM-dd（范围查询）
endTime	否	String	闭班日期 yyyy-MM-dd（范围查询）
year	否	String	开班年份
userID	否	String	班主任ID
userName	否	String	班主任姓名

返回值说明

返回值字段	类型	说明
msg	String	提示信息
code	Int	200成功，其它失败
data	Object	专业信息分页结果集

result结果集返回值字段说明

返回值字段	类型	说明
total	Int	总条数
current	Int	当前页
size	Int	每页条数
rows	Array	当前分页班级信息数据集
data	Object	班级信息（数据为空时为：data[]）
departmentID	String	所属教学单位ID
departmentName	String	所属教学单位名称
classID	String	班级ID(非空)
className	String	班级名称
classCode	String	班级代码
specialtyID	String	所属专业ID
specialtyName	String	所属专业名称
startTime	String	开班日期，格式：yyyy-MM-dd
endTime	String	结班日期，格式：yyyy-MM-dd
eduLength	Int	学制
userID	String	班主任ID
userName	String	班主任姓名
classStudentCount	int	班级学生计数
addTime	String	创建时间

返回结果示例(JSON)

• 返回成功

• 列表查询

{

    "success": true,

    "code": 200,

    "msg": "成功",

    "data": [

        {

            "classID": "03d118f4-d2ba-4899-bcc7-ce7058ba9fbf",

            "className": "18建筑施工（中级）2班",

            "classCode": "18jzsg（zj）2b",

            "specialtyID": "a5a57d63-3ed6-42ee-b1e1-45d57fffef64",

            "specialtyName": "建筑施工",

            "departmentID": "c7da93b8-b676-4f9c-b386-a7680e58efa2",

            "departmentName": "建筑工程系",

            "startTime": "2018-09-01",

            "endTime": "2021-09-01",

            "eduLength": 3,

            "userID": "9761ed9d-fd44-4601-aa14-2b255c8f5362",

            "userName": "王永瀚",

            "remark": null,

            "addTime": "2025-05-06 15:00:13",

            "classStudentCount": 0

        },

        {

            "classID": "10d5dd2a-2057-4207-8cb8-118ccd7e4c21",

            "className": "18级汽车维修班",

            "classCode": "18jqcwxb",

            "specialtyID": "68daf53e-c19f-4b72-bd36-b6caa4915630",

            "specialtyName": "汽车维修",

            "departmentID": "4870f51d-6c78-43a0-8db4-a6182d899ee6",

            "departmentName": "汽车与机电技术系",

            "startTime": "2018-09-01",

            "endTime": "2021-09-01",

            "eduLength": 3,

            "userID": "b54f842e-5a09-4ad7-8240-c828488c4be7",

            "userName": "陈亚楠",

            "remark": null,

            "addTime": "2025-05-06 15:00:14",

            "classStudentCount": 0

        }

    ]

}

• 分页查询

{

    "success": true,

    "code": 200,

    "msg": "成功",

    "data": {

        "total": 317,

        "current": 1,

        "size": 2,

        "rows": [

            {

                "classID": "03d118f4-d2ba-4899-bcc7-ce7058ba9fbf",

                "className": "18建筑施工（中级）2班",

                "classCode": "18jzsg（zj）2b",

                "specialtyID": "a5a57d63-3ed6-42ee-b1e1-45d57fffef64",

                "specialtyName": "建筑施工",

                "departmentID": "c7da93b8-b676-4f9c-b386-a7680e58efa2",

                "departmentName": "建筑工程系",

                "startTime": "2018-09-01",

                "endTime": "2021-09-01",

                "eduLength": 3,

                "userID": "9761ed9d-fd44-4601-aa14-2b255c8f5362",

                "userName": "王永瀚",

                "remark": null,

                "addTime": "2025-05-06 15:00:13",

                "classStudentCount": 0

            },

            {

                "classID": "10d5dd2a-2057-4207-8cb8-118ccd7e4c21",

                "className": "18级汽车维修班",

                "classCode": "18jqcwxb",

                "specialtyID": "68daf53e-c19f-4b72-bd36-b6caa4915630",

                "specialtyName": "汽车维修",

                "departmentID": "4870f51d-6c78-43a0-8db4-a6182d899ee6",

                "departmentName": "汽车与机电技术系",

                "startTime": "2018-09-01",

                "endTime": "2021-09-01",

                "eduLength": 3,

                "userID": "b54f842e-5a09-4ad7-8240-c828488c4be7",

                "userName": "陈亚楠",

                "remark": null,

                "addTime": "2025-05-06 15:00:14",

                "classStudentCount": 0

            }

        ]

    }

}

• 返回失败

  {

    "msg":"具体错误原因",

    "code":-999

  }

版本变更说明：

    无