部门管理
获取部门列表(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 | 教师或班主任的科目 |