获取学生在教师下有权限的班级列表（user/class/get）

使用场景： 查询学生在教师的哪些班级下边,用于判断学生是否有权限上教师的课。

是否需额外授权: 否

请求方式： GET（HTTPS）

请求地址： https://test-oapi.epaas.qq.com/user/class/get?access_token=ACCESS_TOKEN&student_userid=USERID&teacher_userid=USERID

参数说明：

返回结果：

{
    "errcode": 0,
    "errmsg": "ok",
    "departments":[
        {
            "id": 123,
            "class_name": "一班",
            "type":3
        },
        {
            "id": 124,
            "class_name": "劳动",
            "type":4
        }
    ]
}

参数说明：

获取班级列表（class/list）

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

是否需额外授权: 否

请求方式： GET（HTTPS）

请求地址： https://test-oapi.epaas.qq.com/class/list?access_token=ACCESS_TOKEN&department_type=XXX&page_index=XXX&page_size=XXX

参数说明：

返回结果：

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

参数说明：

通过教师获取任课班级（teacher/class/list）

使用场景： 按班级类型查询教师的任课班级列表, 用于教师任课信息展示。

是否需额外授权: 否

请求方式： GET（HTTPS）

请求地址： https://test-oapi.epaas.qq.com/teacher/class/list?access_token=ACCESS_TOKEN&department_type=XXX&teacher_userid=XXX

参数说明：

注意：access_token，可以使用用户票据access_token代替（由/open/access_token获得。） 此时teacher_userid可以不传，由用户本身userid确定教师ID。

返回结果：

注意：不是所有的班级都拥有学部、学段、校区等信息，如果没有，则返回相应类型的空值。

{
  "errmsg": "ok",
  "errcode": 0,
  "departments": [
    {
      "id": 12966844,
      "class_name": "美术",
      "userid": "92452708",
      "name": "letter",
      "type": 3,
      "subject": [
        "美术",
        "数学"
      ]
      "full_id_path": "/11807265/11807266/12739734/12966844",
      "full_path": "/园丁开发测试测试学校1/学生/2017级/美术",
      "grade_id": 12739734,
      "grade_name": "2017级",
      "standard_grade": 64,
      "academic_dpt_id": 5666173,
      "academic_dpt_name": "高中部",
      "org_attribute": 3,
      "org_attribute_name": "高中",
      "campus_id": 0,
      "campus_name": ""
    },
    {
      "id": 12966858,
      "class_name": "体育",
      "userid": "92452708",
      "name": "letter",
      "type": 3,
      "subject": [
        "体育"
      ]
      "full_id_path": "/11807265/11807266/12794859/12966858",
      "full_path": "/园丁开发测试测试学校1/学生/2020级/体育",
      "grade_id": 12794859,
      "grade_name": "2020级",
      "standard_grade": 31,
      "academic_dpt_id": 5674330,
      "academic_dpt_name": "初中部",
      "org_attribute": 5,
      "org_attribute_name": "初中",
      "campus_id": 5666174,
      "campus_name": "大学城校区"
    }
  ]
}

参数说明：

通过班级获取教师（class/teacher/list）

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

是否需额外授权: 否

请求方式： GET（HTTPS）

请求地址： https://test-oapi.epaas.qq.com/class/teacher/list?access_token=ACCESS_TOKEN&department_id=XXX

参数说明：

返回结果：

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

参数说明：

获取学生所属班级列表（student/class/list）

使用场景： 需要支持拉取指定学生所在的班级列表。

是否需额外授权: 否

请求方式： GET（HTTPS）

请求地址： https://test-oapi.epaas.qq.com/student/class/list?access_token=ACCESS_TOKEN&department_type=XXX&userid=XXX

参数说明：

注意：access_token，可以使用用户票据access_token代替（由/open/access_token获得。） 此时userid可以不传，由用户本身userid确定学生ID。

返回结果：

注意：不是所有的班级都拥有学部、学段、校区等信息，如果没有，则返回相应类型的空值。

{
  "errmsg": "ok",
  "errcode": 0,
  "departments": [
    {
      "id": 12966843,
      "class_name": "物理",
      "department_type": 8,
      "full_id_path": "/11807265/11807266/11810634/12966843",
      "full_path": "/园丁开发测试测试学校1/学生/2019级/物理",
      "grade_id": 5665864,
      "grade_name": "2020级",
      "standard_grade": 91,
      "academic_dpt_id": 5665647,
      "academic_dpt_name": "高中一部",
      "org_attribute": 3,
      "org_attribute_name": "高中",
      "campus_id": 0,
      "campus_name": ""
    },
    {
      "id": 12966844,
      "class_name": "美术",
      "department_type": 8,
      "full_id_path": "/11807265/11807266/12739734/12966844",
      "full_path": "/园丁开发测试测试学校1/学生/2017级/美术",
      "grade_id": 5665864,
      "grade_name": "2020级",
      "standard_grade": 91,
      "academic_dpt_id": 5665637,
      "academic_dpt_name": "高中二部",
      "org_attribute": 3,
      "org_attribute_name": "高中",
      "campus_id": 5668438,
      "campus_name": "大学城校区"
    }
  ]
}

参数说明：

批量添加班级教师（/class/teacher/batch_add）

使用场景： 批量添加班级的教师

是否需额外授权: 否

请求方式： POST（HTTPS）

请求地址： https://test-oapi.epaas.qq.com/class/teacher/batch_add?access_token=ACCESS_TOKEN

请求包体：

 {
     "department_id":3032762, 
     "teachers":[
       {"userid":"30046158", "type":3,"subject":["语文","其他学科"]},
       {"userid":"30046160", "type":3,"subject":["数学"]}
     ]
 }

参数说明：

返回结果：

{
    "errmsg": "ok",
    "errcode": 0,
    "result_list": [
        {
            "errcode": 0,
            "errmsg": "OK",
            "userid": "30046158"
        },
        {
            "errcode": 0,
            "errmsg": "OK",
            "userid": "30046160"
        }
    ]
}

参数说明：

批量删除班级教师（/class/teacher/batch_delete）

使用场景： 批量删除班级的教师

是否需额外授权: 否

请求方式： POST（HTTPS）

请求地址： https://test-oapi.epaas.qq.com/class/teacher/batch_delete?access_token=ACCESS_TOKEN

请求包体：

 {
     "department_id":3032762, 
     "teachers":[
     {"userid":"30046158", "type":3},
     {"userid":"30046160", "type":3}
     ]
}

参数说明：

返回结果：

{
    "errmsg": "ok",
    "errcode": 0,
    "result_list": [
        {
            "errcode": 0,
            "errmsg": "OK",
            "userid": "30046158"
        },
        {
            "errcode": 1,
            "errmsg": "班级不存在该教师",
            "userid": "30046160"
        }
    ]
}

参数说明：