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


请求方式:POST(HTTPS
请求地址:https://qyapi.weixin.qq.com/cgi-bin/school/department/update?access_token=ACCESS_TOKEN

请求包体:

{
   "name": "一年级",
   "parentid": 5,
   "id": 2,
   "register_year":2018,
   "standard_grade":1,
   "order":1,
   "new_id": 100,
   "department_admins": [
	   {
		   "op": 0,
		   "userid": "zhangsan",
		   "type": 3,
		   "subject":"语文"
	   },
	   {
		   "op": 1
		   "userid": "lisi",
		   "type": 4,
		   "subject":"数学"
	   }
   ]
}

参数说明:

参数必须说明
access_token调用接口凭证
name部门名称,如果部门为标准年级则忽略该字段。长度限制为1~32个字符,字符不能包括-:*?"<>/,*
parentid父部门id,32位整型
id部门id,32位整型,必须大于0。
new_id修改为新的id
register_year入学年份,32位整型,格式为YYYY,输入范围为1970~2100,仅当部门类型为年级(2)时生效
standard_grade标准年级,32位整型,参数值含义详见标准年级对照表,仅当部门类型为年级(2)时生效
order在父部门中的次序值。order值大的排序靠前。有效的值范围是[0, 2^32)
department_admins部门管理员列表
department_admins.opop=0表示新增或者更新,op=1表示删除管理员
department_admins.userid对应管理端的账号,企业内必须唯一。不区分大小写,长度为1~64个字节
department_admins.type部门管理员类型, 1表示校区负责人,2表示年级负责人,3表示班主任,4表示任课老师,5表示学段负责人
department_admins.subject教师的科目,仅班主任和任课老师可以设置,科目的最多15个字符,仅支持设置一个科目
注意,班级的父部门必须是年级,也就是说type为1的部门的父部门type值必须是2。
当传入的standard_grade为0时,表示将此部门转换为非标准年级
管理员类型须与部门类型保持一致,即校区负责人只能配置到校区部门,班主任和任课老师只能设置到班级

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

应用类型权限要求
自建应用配置到「 家校沟通- 读取和编辑家校通讯录的应用」中
第三方应用需拥有「家校沟通」使用和编辑 权限

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

返回结果:

{
   "errcode": 0,
   "errmsg": "updated",
}

参数说明:

参数说明
errcode返回码
errmsg对返回码的文本描述内容
上一篇
创建部门
下一篇
删除部门