获取学生在教师的班级列表

使用场景： 调用本接口，查询学生在教师的哪些班级中，用于判断学生是否有权限上教师的课。

权限说明

请求方式： GET（HTTPS）

请求地址： https://test-oapi.epaas.qq.com/user/class/get

Query参数:

返回参数：

请求示例：

GET https://test-oapi.epaas.qq.com/user/class/get?access_token=ACCESS_TOKEN&student_userid=STUDENT_USERID&teacher_userid=TEACHER_USERID

返回示例：

{
    "errcode": 0,
    "errmsg": "ok",
    "departments": [
        {
            "id": 5896625,
            "subject": "物理",
            "type": 3,
            "full_path": "/实验中学/学生/大学城/高中部/2020级/5班",
            "class_name": "5班",
            "source": 1
        }
    ]
}

获取班级列表

使用场景： 调用本接口，按班级类型分页查询班级列表, 用于班级列表展示。

权限说明

请求方式： GET（HTTPS）

请求地址： https://test-oapi.epaas.qq.com/class/list

Query参数:

返回参数：

请求示例：

GET https://test-oapi.epaas.qq.com/class/list?access_token=ACCESS_TOKEN&department_type=DEPARTMENT_TYPE&page_index=PAGE_INDEX&page_size=PAGE_SIZE

返回示例：

{
    "errcode": 0,
    "errmsg": "ok",
    "total": 100,
    "departments":[
        {
            "id": 123,
            "class_name": "一班",
            "parentid": 10,
            "level": 4
        },
        {
            "id": 124,
            "class_name": "二班",
            "parentid": 12,
            "level": 3
        }
    ]
}

通过教师获取任课班级

使用场景： 调用本接口，按班级类型查询教师的任课班级列表, 用于教师任课信息展示。注意：不是所有的班级都拥有学部、学段、校区等信息，如果没有，则返回相应类型的空值。

权限说明

请求方式： GET（HTTPS）

请求地址： https://test-oapi.epaas.qq.com/teacher/class/list

Query参数:

返回参数：

请求示例：

GET https://test-oapi.epaas.qq.com/teacher/class/list?access_token=ACCESS_TOKEN&department_type=DEPARTMENT_TYPE&teacher_userid=TEACHER_USERID&full_path=FULL_PATH&department_info=DEPARTMENT_INFO

返回示例：

{
    "errcode": 0,
    "errmsg": "ok",
    "departments": [
        {
            "id": 5896625,
            "class_name": "5班",
            "userid": "372533",
            "name": "小明",
            "type": 3,
            "subject": [
                "物理"
            ],
            "source": 1,
            "full_id_path": "/5891840/5891841/5896622/5896623/5896624/5896625",
            "full_path": "/实验中学/学生/大学城/高中部/2020级/5班",
            "grade_id": 5896624,
            "grade_name": "2020级",
            "standard_grade": 92,
            "academic_dpt_id": 5896623,
            "academic_dpt_name": "高中部",
            "org_attribute": 3,
            "org_attribute_name": "高中",
            "campus_id": 5896622,
            "campus_name": "大学城"
        }
    ]
}

通过班级获取教师

使用场景： 调用本接口，查询班级的教师列表, 用于班级信息展示。

权限说明

请求方式： GET（HTTPS）

请求地址： https://test-oapi.epaas.qq.com/class/teacher/list

Query参数:

返回参数：

请求示例：

GET https://test-oapi.epaas.qq.com/class/teacher/list?access_token=ACCESS_TOKEN&department_id=DEPARTMENT_ID

返回示例：

{
    "errcode": 0,
    "errmsg": "ok",
    "departments":[
        {
            "id": 123,
            "userid": "123",
            "name": "张三",
            "type": 3,
            "subject": [
                "语文"
            ],
            "source":1
        },
        {
            "id": 123,
            "userid": "234",
            "name": "李四",
            "type": 4,
            "subject": [
                "数学"
            ],
            "source":2
        }
    ]
}

获取学生所属班级列表

使用场景： 调用本接口，获取指定学生所在的班级列表。注意：不是所有的班级都拥有学部、学段、校区等信息，如果没有，则返回相应类型的空值。

权限说明

请求方式： GET（HTTPS）

请求地址： https://test-oapi.epaas.qq.com/student/class/list

Query参数:

返回参数：

请求示例：

GET https://test-oapi.epaas.qq.com/student/class/list?access_token=ACCESS_TOKEN&department_type=DEPARTMENT_TYPE&userid=USERID

返回示例：

{
  "errmsg": "ok",
  "errcode": 0,
  "departments": [
        {
            "id": 5896625,
            "class_name": "5班",
            "userid": "372533",
            "name": "小明",
            "type": 3,
            "subject": [
                "物理"
            ],
            "source": 1,
            "full_id_path": "/5891840/5891841/5896622/5896623/5896624/5896625",
            "full_path": "/实验中学/学生/大学城/高中部/2020级/5班",
            "grade_id": 5896624,
            "grade_name": "2020级",
            "standard_grade": 92,
            "academic_dpt_id": 5896623,
            "academic_dpt_name": "高中部",
            "org_attribute": 3,
            "org_attribute_name": "高中",
            "campus_id": 5896622,
            "campus_name": "大学城"
        }
    ]
}

批量通过班级获取班主任

使用场景： 调用本接口，批量通过班级获取班主任

权限说明

请求方式： GET（HTTPS）

请求地址： https://test-oapi.epaas.qq.com/user/batch_get_class_admins

Query参数:

返回参数：

请求示例：

POST https://test-oapi.epaas.qq.com/user/batch_get_class_admins?access_token=ACCESS_TOKEN

请求示例：

{
"department_ids":[10001,10002]
}

返回示例：

{
    "errcode": 0,
    "errmsg": "ok",
    "data_list":[
        {
            "department_id": 123,
            "userid": "123",
            "name": "张三"
        },
        {
            "department_id": 123,
            "userid": "234",
            "name": "李四"
        }
    ]
}