一、基本信息
接口名称：获取全校课表接口
接口说明：获取当前学校本周的课表数据，包括行政班，教学班和选修班课表，课表接口返回为当前周一周课表（1-7天，即周一到周日），下周课表为下一周（1-7天）课表。
请求地址：${BASEURL}/dataconnectorserv/integration/scheduler/getSchedule （本周课表）
请求地址：${BASEURL}/dataconnectorserv/integration/scheduler/getNextSchedule （下周课表)
请求方式：POST
请求类型：application/json
接口频率：接口调用上限500次/天
接口版本：3.0
修改日期：2023-12-05
小提示【重要！重要！重要！】
对接课表接口时，请先阅读“服务能力->接入概述->场景说明”，课表与班牌集成和注意事项。
二、请求参数
| 参数名 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| appKey | String | 是 | 平台提供的唯一标识 |
| schoolID | String | 是 | 学校ID，从学校列表获取 |
{
"appKey": "36s2zllw",
"schoolID": "wca5opSRt2tyyBSLqOjdoS=="
}
三、响应结果
| 响应参数名称 | 响应参数类型 | 是否有值 | 说明 |
|---|---|---|---|
| semester | Object | 是 | 学校学期 |
| schedule | Array | 是 | 学校课表列表，每个对象代表一节课 |
| classFullName | String | 是 | 班级全称 |
| qualifiedClassID | String | 是 | 班级ID |
| classType | String | 是 | 班级类型 |
| weekDay | String | 是 | 上课周几，例如：1表示星期一 |
| date | String | 是 | 上课日期 |
| oddDual | String | 是 | 单双周：0表示非单双周，1单周，2双周，week 本周0，下周1，例如：本周上美术课，下周音乐课 |
| timeslot | String | 是 | 上课节次，例如：1表示第一节课 |
| beginTime | String | 是 | 上课时间（优先使用基础数据作息timeSettings） |
| endTime | String | 是 | 下课时间（优先使用基础数据作息timeSettings） |
| subjectID | String | 是 | 科目ID |
| subjectName | String | 是 | 科目名称 |
| teachers | Array | 否 | 教师列表 |
| teacherEID | String | 否 | 教师EID |
| teacherName | String | 否 | 教师姓名 |
| locationID | String | 否 | 教室ID |
| locationName | String | 否 | 教室名称 |
| timeSettings | Object | 是 | 基础作息（作息框架与作息时间），即将弃用，从基础作息接口获取 |
| daysPerWeek | String | 是 | 一周几天上课 |
| earlyMorningLessons | String | 是 | 早间节次数 |
| morningLessons | String | 是 | 上午节次数 |
| afternoonLessons | String | 是 | 下午节次数 |
| nightLessons | String | 是 | 晚间节次数 |
| times | Array | 否 | 每天节次时间安排【注：null值或空数组，表示有年级作息时，全校times作息为空】 |
| timeslotInDay | String | 否 | 上课节次，例如：1表示第一节课 |
| beginTime | String | 否 | 开始时间（分钟） |
| duration | String | 否 | 上课时间（分钟） |
| breakDuration | String | 否 | 课间时间（分钟） |
| gradeTimeSettings | Array | 否 | 年级作息 |
| grades | Array | 否 | 年级列表 |
| groupTimes | Array | 否 | 年级作息时间 |
| schoolDays | Array | 否 | 学校上课天数，表示一周作息的星期，1表示星期一，2表示星期二 |
| times | Array | 否 | 作息时间 |
| timeslotInDay | String | 否 | 上课节次，例如：1表示第一节课 |
| beginTime | String | 否 | 开始时间（分钟） |
| duration | String | 否 | 上课时间（分钟） |
| breakDuration | String | 否 | 课间时间（分钟） |
{
"status": "success",
"result": {
"semester": "2023-2024第一学期",
"schedule": [
{
"classFullName": "高二1班",
"qualifiedClassID": "1012023-1",
"classType": "行政班",
"weekDay": 1,
"date": "2023-10-16",
"oddDual": "0",
"timeslot": 4,
"beginTime": "10:30",
"endTime": "11:10",
"subjectID": "8",
"subjectName": "语文",
"teachers": [
{
"teacherEID": "1012022060",
"teacherName": "语文老师19"
}
],
"locationID": "26",
"locationName": "高二1班"
},
{
"classFullName": "高二地理7班",
"qualifiedClassID": "1012023-61",
"classType": "教学班",
"weekDay": 2,
"date": "2023-10-17",
"oddDual": "0",
"timeslot": 5,
"beginTime": "11:20",
"endTime": "12:00",
"subjectID": "6",
"subjectName": "地理",
"teachers": [],
"locationID": null,
"locationName": null
},
{
"classFullName": "篮球兴趣课",
"qualifiedClassID": "11010",
"classType": "选修班",
"weekDay": 4,
"date": "2023-10-19",
"oddDual": "0",
"timeslot": 9,
"beginTime": "16:10",
"endTime": "16:50",
"subjectID": "1101",
"subjectName": "篮球兴趣课",
"teachers": [
{
"teacherEID": "1012022098",
"teacherName": "体育老师"
}
],
"locationID": "20",
"locationName": "多媒体教室"
}
],
"timeSettings": {
"daysPerWeek": 5,
"earlyMorningLessons": 0,
"morningLessons": 2,
"afternoonLessons": 3,
"nightLessons": 0,
"times": [
{
"timeslotInDay": 1,
"beginTime": "07:50",
"duration": 40,
"breakDuration": 10
},
{
"timeslotInDay": 2,
"beginTime": "08:40",
"duration": 40,
"breakDuration": 20
},
{
"timeslotInDay": 3,
"beginTime": "09:40",
"duration": 40,
"breakDuration": 10
},
{
"timeslotInDay": 4,
"beginTime": "10:30",
"duration": 40,
"breakDuration": 10
},
{
"timeslotInDay": 5,
"beginTime": "11:20",
"duration": 40,
"breakDuration": 0
}
]
},
"gradeTimeSettings": []
}
}
年级作息示例【gradeTimeSettings】
{
"status": "success",
"result": {
"semester": "2023-2024第一学期",
"schedule": [
{
"classFullName": "高一1班",
"qualifiedClassID": "2012023-1",
"classType": "行政班",
"weekDay": 1,
"date": "2023-10-16",
"oddDual": "0",
"timeslot": 7,
"beginTime": "14:30",
"endTime": "15:10",
"subjectID": "104",
"subjectName": "自习",
"teachers": [],
"locationID": "1",
"locationName": "高一1班"
}
],
"timeSettings": {
"daysPerWeek": 5,
"earlyMorningLessons": 0,
"morningLessons": 2,
"afternoonLessons": 1,
"nightLessons": 0,
"times": null
},
"gradeTimeSettings": [
{
"grades": [
"1012023",
"1012022",
"1012021"
],
"groupTimes": [
{
"schoolDays": [
1,
2,
3,
4,
5
],
"times": [
{
"timeslotInDay": 1,
"beginTime": "07:50",
"duration": 40,
"breakDuration": 10
},
{
"timeslotInDay": 2,
"beginTime": "08:40",
"duration": 40,
"breakDuration": 20
},
{
"timeslotInDay": 3,
"beginTime": "09:40",
"duration": 40,
"breakDuration": 10
}
]
}
]
},
{
"grades": [
"2012022",
"3012023"
],
"groupTimes": [
{
"schoolDays": [
1,
2,
3,
4,
5
],
"times": [
{
"timeslotInDay": 1,
"beginTime": "07:50",
"duration": 40,
"breakDuration": 10
},
{
"timeslotInDay": 2,
"beginTime": "08:40",
"duration": 40,
"breakDuration": 10
},
{
"timeslotInDay": 3,
"beginTime": "09:30",
"duration": 40,
"breakDuration": 10
}
]
}
]
}
]
}
}