部门管理

获取部门列表(school/department/list)

请求方式:GET(HTTPS
请求地址:https://oapi.szns.edu.cn/school/department/list?access_token=ACCESS_TOKEN&id=ID

参数说明 :

参数 必须 说明
access_token 调用接口凭证
id 部门id。获取指定部门及其下的子部门。 如果不填,默认获取全量组织架构

权限说明:

只能拉取token对应的应用的权限范围内的部门列表

返回结果:

{
    "errcode": 0,
    "errmsg": "ok",
    "departments": [
        {
            "name": "一年级",
            "parentid": 1,
            "id": 2,
            "type":2,
            "register_year":2018,
            "standard_grade":1,          
            "department_admins": [
                {
                    "userid": "zhangsan",
                    "type": 1
                },
                {
                    "userid": "lisi",
                    "type": 2
                }
            ]
        },
        {
            "name": "一年级一班",
            "parentid": 1,
            "id": 3,
            "type":1,
            "department_admins": [
                {
                    "userid": "zhangsan",
                    "type": 3,
                    "subject":"语文"
                },
                {
                    "userid": "lisi",
                    "type": 4,
                    "subject":"数学"
                }
            ]
        }
    ]
}

参数说明:

参数 说明
errcode 返回码
errmsg 对返回码的文本描述内容
department 部门列表数据。
id 部门id,根部门固定为1
type 部门类型,32位整型,1表示班级,2表示年级,3表示学段,4表示校区,5表示学校(根部门)
name 部门名称
parentid 父亲部门id,根部门该项为0
register_year 入学年份,仅标准年级返回,格式为YYYY
standard_grade 标准年级,当为部门为标准年级时返回,返回值具体请参考标准年级对照表
order 在父部门中的次序值,order值大的排序靠前。有效的值范围是[0, 2^32),仅在API设置后才返回
department_admins.userid 部门管理员的userid
department_admins.type 部门管理员的类型,1表示校区负责人,2表示年级负责人,3表示班主任,4表示任课老师,5表示学段负责人
department_admins.subject 教师或班主任的科目

2019 Tencent SmartCampus. all right reserved,powered by Gitbooktime: 2021-03-24 08:03:21

results matching ""

    No results matching ""

    results matching ""

      No results matching ""