第三方应用开发 服务端API 家校沟通 部门管理 获取部门列表
获取部门列表
最后更新:2023/12/01
可联系渠道经理采购或代理智慧硬件接口已支持设备 联系渠道经理
获取部门列表
最后更新:2023/12/01

请求方式:GET(HTTPS
请求地址:https://qyapi.weixin.qq.com/cgi-bin/school/department/list?access_token=ACCESS_TOKEN&id=ID

参数说明 :

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

权限说明:
调用的应用需要满足如下的权限

应用类型权限要求
自建应用配置到「 家校沟通- 读取和编辑家校通讯录的应用」或「 家校沟通- 读取家校通讯录的应用」或“家长可使用应用”列表中
代开发应用具有 「家校沟通」权限
第三方应用具有 「家校沟通」使用权限

注: 从2023年12月1日0点起,不再支持通过系统应用secret调用接口,存量企业暂不受影响 查看详情

返回结果:

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

参数说明:

参数说明
errcode返回码
errmsg对返回码的文本描述内容
departments部门列表数据
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教师或班主任的科目
open_group_chat是否开启班级群,1表示开启,0表示关闭。仅部门类型为班级时才返回该字段
group_chat_id班级群id。仅部门类型为班级时且open_group_chat为1时才返回该字段
is_graduated是否是已毕业,1表示是,0表示不是。仅部门类型为年级时才返回该字段
上一篇
删除部门
下一篇
标准年级对照表