一、基本信息
接口名称:获取全部行政班信息接口
接口说明:当前学校所有行政班班级列表
请求地址:${BASEURL}/dataconnectorserv/integration/basic/getClasses
请求方式:POST
请求类型:application/json
接口频率:接口调用上限500次/天
接口版本:3.0
修改日期:2023-12-05
二、请求参数
| 参数名 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| appKey | String | 是 | 平台提供的唯一标识 |
| schoolID | String | 是 | 学校ID,从学校列表获取 |
{
"appKey": "36s2zllw",
"schoolID": "wca5opSRt2tyyBSLqOjdoS=="
}
三、响应结果
| 响应参数名称 | 响应参数类型 | 是否有值 | 说明 |
|---|---|---|---|
| classes | Array | 是 | 班级列表 |
| entranceYear | String | 是 | 入学年份 |
| eduStage | String | 是 | 学校学段:幼儿园,小学,初中,高中,大学 |
| gradeID | String | 是 | 年级ID |
| gradeName | String | 是 | 年级名称 |
| classLabels | String | 否 | 班级标签 |
| classFullName | String | 是 | 班级名称 |
| locationID | String | 否 | 班级教室ID,null值,表示课表行政班未安排教室 |
| locationName | String | 否 | 班级教室名称,null值,表示课表行政班未安排教室 |
| qualifiedClassID | String | 是 | 全校唯一ID |
| classTeacher | String | 否 | 班主任,null值,表示未填写班主任 |
| teacherEID | String | 否 | 班主任-教师EID |
| teacherName | String | 否 | 班主任-教师姓名 |
| updateTime | String | 是 | 更新时间(格式化UTC时间,比北京时间早8小时,UTC+时区差=本地时间) |
{
"status": "success",
"result": {
"classes": [
{
"entranceYear": "2023",
"eduStage": "初中",
"gradeID": "2012023",
"gradeName": "初一",
"classLabels": [
"冲刺班"
],
"classFullName": "初二1班",
"locationID": "10",
"locationName": "101教室",
"qualifiedClassID": "2012023-1",
"classTeacher": {
"teacherEID": "1012022001",
"teacherName": "留乐家"
},
"updateTime": "2023-01-11T07:30:40Z"
},
{
"entranceYear": "2023",
"eduStage": "高中",
"gradeID": "1012023",
"gradeName": "高一",
"classLabels": [
"火箭班"
],
"classFullName": "高一1班",
"locationID": "12",
"locationName": "高一1班",
"qualifiedClassID": "1012021-2",
"classTeacher": {
"teacherEID": "15120288434",
"teacherName": "杨通银"
},
"updateTime": "2023-01-11T07:30:41Z"
},
{
"entranceYear": "2021",
"eduStage": "高中",
"gradeID": "1012021",
"gradeName": "高一",
"classLabels": [],
"classFullName": "高一2班",
"locationID": null,
"locationName": null,
"qualifiedClassID": "1012021-2",
"classTeacher": null,
"updateTime": "2023-01-11T07:30:41Z"
}
]
}
}