行政班管理
行政班即指传统的班级,如高一(1)班。
每一个行政班会有一个正班主任和多个副主任,以及多个学生,一个教室。
每一个行政班对应多个班级管理里的教学班。行政班并没有学期的概念,而教学班是按学期划分的。因此,在获取行政班的教学课程时,请根据需要传递学期参数(semester_id)。
一个教学班也可能会有多个行政班的学生一块上课,比如体育教学班,多个行政班一块上课。
数据结构
字段名称 | 类型 | 描述 |
---|---|---|
id | integer | |
school_id | string | |
name | string | 行政班名称, 该字段不唯一,加上 grade_name 才唯一 |
classroom | Object | 行政班的教室 |
graduates_in | int | 毕业届别 |
grade_name | string | 当前年级, 与 graduates_in 一一对应 |
director | Object | 正班主任 |
teachers | Array | 班主任,包含正副班主任,副主任可能有多个 |
students | Array | 学生 |
示例:
{
"id":85,
"school_id":3,
"name":"高一(1)班",
"graduates_in":2023,
"grade_name": "高一",
"classroom" : {
"id" : 26353,
"name" : "501教室",
"type" : "classroom",
"school_id" : 3,
"updated_at" : "2017-08-30 08:53:58",
"created_at" : "2017-08-30 08:53:58",
},
"director": {
/* 用户对象 */
},
"teachers":[
/* 多个用户对象 */
],
"students":[
/* 多个用户对象 */
],
"created_at":"2018-03-13 21:03:35",
"updated_at":"2018-03-13 21:03:35"
}
接口
1、获取行政班列表
GET /api/v1/admin-classes
Parameters
参数名 | 类型 | 描述 |
---|---|---|
graduates_in | number | 届别 |
classroom | string | 教室 |
name | string | 行政班名称 |
Response 200
行政班列表,单个行政班结构见上述示例。
2、获取行政班信息
GET /api/v1/admin-classes/{id}
Parameters
参数名 | 类型 | 描述 |
---|---|---|
id | number | 行政班 id |
Response 200
行政班信息,结构见上述示例。