当前版本:
version= V1.0
接口功能:
用于分页获取RunLan平台课表信息。
接口地址:
/api/v1/weekTable/queryWeekTable
请求方式:
POST
请求参数:
Body
| 参数名称 | 是否必选 | 参数类型 | 说明/示例 |
|---|---|---|---|
| selType | 是 | Int | 查询类型 0:分页查询,1:列表查询 |
| page | 条件必选(当isSelAll=0时必选,下同) | Int | 页码 |
| pageSize | 条件必选 | Int | 每页大小 |
| weekOrdinal | 否 | String | 周次(例:查询第一周,周次传入1) |
| timeTableID | 否 | String | 课表ID |
| classID | 否 | String | 班级ID |
| courseID | 否 | String | 课程ID |
| termID | 否 | String | 学期ID |
| departmentID | 否 | String | 部门ID |
| roomID | 否 | String | 教室ID |
| masterTeacherID | 否 | String | 主课教师ID |
| subTeacherID | 否 | String | 辅课教师ID |
返回值说明
| 返回值字段 | 类型 | 说明 |
|---|---|---|
| msg | String | 提示信息 |
| code | Int | 200成功,其它失败 |
| data | Object | 部门信息分页结果集 |
result结果集返回值字段说明
| 返回值字段 | 类型 | 说明 |
|---|---|---|
| total | Int | 总条数 |
| current | Int | 当前页 |
| size | Int | 每页条数 |
| rows | Array | 当前分页课表信息数据集 |
| data | Object | 课表信息(当数据为空时为data:[]) |
| timeTableID | String | 周课表ID |
| classID | String | 班级ID |
| className | String | 班级名称 |
| courseID | Int | 课程ID |
| courseName | Int | 课程名称 |
| termID | Int | 学期ID |
| departmentID | String | 所属教学单位ID |
| departmentName | String | 所属教学单位名称 |
| roomID | Int | 教室ID |
| roomName | String | 教室名称 |
| masterTeacherIDs | String | 主课教师IDs,多人使用半角逗号分隔 |
| masterTeacherNames | String | 主课教师姓名,多人使用半角逗号分隔 |
| subTeacherIDs | String | 辅教老师IDs,多人使用半角逗号分隔 |
| subTeacherNames | String | 辅教老师姓名,多人使用半角逗号分隔 |
| isLargeClass | Int | 合班标识:两个相同的数字比较两个班级在一起合班上课 |
| startWeek | Int | 开始周 |
| endWeek | Int | 结束周 |
| weekDay | Int | 周次,如周三- 3 |
| sectionIndex | Int | 节次,如第1节课- 1 |
| addTime | String | 生成时间,格式:yyyy-MM-dd HH:mm:ss |
| studyType | Int | 课类型:0正课1早自习2晚自习 |
| courseDate | String | 上课日期,格式:yyyy-MM-dd |
| dataType | Int | 数据类型 : 0:周课表,1:排课的课表 |
| specialtyID | String | 专业ID |
| lessonPlanID | String | 原教学计划ID |
| applyWeek | String | 适用周 |
| state | Int | 排课状态0成功,1冲突 |
| changeState | String | 操作状态:0未进行任何操作,1特殊休息日,2特殊工作日,3调课,4代课,5非工作日(周末等),6临时停课,7临时补课,8合班上课,9不在当前学期内。状态可同时存在,分割 |
| weekOrdinal | String | 第几周 |
返回结果示例(JSON)
返回成功
列表查询
{
"success": true,
"code": 200,
"msg": "成功",
"data": [
{
"timeTableID": "00022379-64D4-849B-AA83-5CD2E9E72CC7",
"classID": "148cd798-f63b-4c03-8f3c-f4142df86396",
"className": "2021级建筑施工五年高级1班",
"courseID": "31370c16-2cda-4a5b-a17a-f2a0fd394260",
"courseName": "主体结构综合实训",
"termID": "f8634fa8-2921-45a0-805c-65e18d49b649",
"departmentID": "c7da93b8-b676-4f9c-b386-a7680e58efa2",
"departmentName": null,
"roomID": "A01AF095-647A-657A-7927-78F1F045165E",
"roomName": "3#教学楼501",
"masterTeacherIDs": "5503b716-e741-4318-8ba2-cad31daede3d",
"masterTeacherNames": "何润",
"subTeacherIDs": null,
"subTeacherNames": null,
"isLargeClass": 0,
"startWeek": 1,
"endWeek": 20,
"weekDay": 4,
"sectionIndex": 2,
"addTime": "2025-04-16 23:02:38",
"studyType": null,
"courseDate": "2025-03-06",
"dataType": 1,
"specialtyID": null,
"lessonPlanID": null,
"applyWeek": "1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20",
"state": null,
"changeState": "0",
"weekOrdinal": "4"
},
{
"timeTableID": "6D60AA6C-1931-80F3-D3D6-560CF3481670",
"classID": "148cd798-f63b-4c03-8f3c-f4142df86396",
"className": "2021级建筑施工五年高级1班",
"courseID": "31370c16-2cda-4a5b-a17a-f2a0fd394260",
"courseName": "主体结构综合实训",
"termID": "f8634fa8-2921-45a0-805c-65e18d49b649",
"departmentID": "c7da93b8-b676-4f9c-b386-a7680e58efa2",
"departmentName": null,
"roomID": "A01AF095-647A-657A-7927-78F1F045165E",
"roomName": "3#教学楼501",
"masterTeacherIDs": "5503b716-e741-4318-8ba2-cad31daede3d",
"masterTeacherNames": "何润",
"subTeacherIDs": null,
"subTeacherNames": null,
"isLargeClass": 0,
"startWeek": 1,
"endWeek": 20,
"weekDay": 4,
"sectionIndex": 1,
"addTime": "2025-04-16 23:02:38",
"studyType": null,
"courseDate": "2025-03-06",
"dataType": 1,
"specialtyID": null,
"lessonPlanID": null,
"applyWeek": "1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20",
"state": null,
"changeState": "0",
"weekOrdinal": "4"
}
]
}
分页查询
{
"success": true,
"code": 200,
"msg": "成功",
"data": {
"total": 4,
"current": 1,
"size": 2,
"rows": [
{
"timeTableID": "00022379-64D4-849B-AA83-5CD2E9E72CC7",
"classID": "148cd798-f63b-4c03-8f3c-f4142df86396",
"className": "2021级建筑施工五年高级1班",
"courseID": "31370c16-2cda-4a5b-a17a-f2a0fd394260",
"courseName": "主体结构综合实训",
"termID": "f8634fa8-2921-45a0-805c-65e18d49b649",
"departmentID": "c7da93b8-b676-4f9c-b386-a7680e58efa2",
"departmentName": null,
"roomID": "A01AF095-647A-657A-7927-78F1F045165E",
"roomName": "3#教学楼501",
"masterTeacherIDs": "5503b716-e741-4318-8ba2-cad31daede3d",
"masterTeacherNames": "何润",
"subTeacherIDs": null,
"subTeacherNames": null,
"isLargeClass": 0,
"startWeek": 1,
"endWeek": 20,
"weekDay": 4,
"sectionIndex": 2,
"addTime": "2025-04-16 23:02:38",
"studyType": null,
"courseDate": "2025-03-06",
"dataType": 1,
"specialtyID": null,
"lessonPlanID": null,
"applyWeek": "1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20",
"state": null,
"changeState": "0",
"weekOrdinal": "4"
},
{
"timeTableID": "6D60AA6C-1931-80F3-D3D6-560CF3481670",
"classID": "148cd798-f63b-4c03-8f3c-f4142df86396",
"className": "2021级建筑施工五年高级1班",
"courseID": "31370c16-2cda-4a5b-a17a-f2a0fd394260",
"courseName": "主体结构综合实训",
"termID": "f8634fa8-2921-45a0-805c-65e18d49b649",
"departmentID": "c7da93b8-b676-4f9c-b386-a7680e58efa2",
"departmentName": null,
"roomID": "A01AF095-647A-657A-7927-78F1F045165E",
"roomName": "3#教学楼501",
"masterTeacherIDs": "5503b716-e741-4318-8ba2-cad31daede3d",
"masterTeacherNames": "何润",
"subTeacherIDs": null,
"subTeacherNames": null,
"isLargeClass": 0,
"startWeek": 1,
"endWeek": 20,
"weekDay": 4,
"sectionIndex": 1,
"addTime": "2025-04-16 23:02:38",
"studyType": null,
"courseDate": "2025-03-06",
"dataType": 1,
"specialtyID": null,
"lessonPlanID": null,
"applyWeek": "1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20",
"state": null,
"changeState": "0",
"weekOrdinal": "4"
}
]
}
}
返回失败
{
"msg":"具体错误原因",
"code":-999
}
版本变更说明:
无