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


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

请求包体:

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

参数说明:

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

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

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

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

返回结果:

{
   "errcode": 0,
   "errmsg": "created",
   "id": 2
}

参数说明:

参数说明
errcode返回码
errmsg对返回码的文本描述内容
id创建的部门id
上一篇
获取部门家长详情
下一篇
更新部门