K12服务体系技术规范 API接口说明

公共-班级列表

URL:/common/class_list

请求方式:GET

Headers:

参数 说明
Authorization access_token访问令牌

参数:

名称 必选 类型 说明
school_code true char 学校编码

响应:

名称 类型 说明
status int 状态
msg char 返回信息
grade_id int 年级id
grade_name char 年级名称
class_id int 班级id
class_name char 班级名称
alias char 班级别名
code char 班级code
term_id int 当前学年

JSON示例:

成功返回

{
    "list":[ 
        {
            "grade_id": 201,
            "grade_name": "初一",
            "class_list":[
                {
                    "class_id": 1,
                    "class_name": "(1)班",
                    "alias": "",
                    "code": "3VOBF3lg"
                },                   
                {
                    "class_id": 2,
                    "class_name": "(2)班",
                    "alias": "",
                    "code": "69YVp62S"
                },
                {
                    "class_id": 3,
                    "class_name": "(3)班",
                    "alias": "",
                    "code": "0BYPOJ1q"
                }                      
            ]
        },
        {
            "grade_id": 202,
            "grade_name": "初二",
            "class_list":[
                {
                    "class_id": 7,
                    "class_name": "(1)班",
                    "alias": "",
                    "code": "89k25pXD"
                },                   
                {
                    "class_id": 8,
                    "class_name": "(2)班",
                    "alias": "",
                    "code": "T7m6xaxd"
                }                    
            ]
        }
    ],
    "term_id": 2019
}

失败返回

{
    "status": <ErrorCode>,
    "msg": <ErrorMessage>
}