Asp.net【企业微信开发】部门管理（二）更新部门

范范

通讯录同步相关接口，可以对部门、成员、标签等通讯录信息进行查询、添加、修改、删除等操作。本次我们主要说下通讯录管理中的部门管理， 主要从一下几个接口说明：

1. 创建部门
2. 更新部门
3. 删除部门
4. 获取部门列表


更新部门

---

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

请求包体（如果非必须的字段未指定，则不更新该字段）：

[C#] 纯文本查看 复制代码

{
   "id": 2,
   "name": "广州研发中心",
   "name_en": "RDGZ",
   "parentid": 1,
   "order": 1
}

请求参数说明：

[C#] 纯文本查看 复制代码

参数                                必须                说明
1. access_token                是        调用接口凭证
2. id                                是        部门id
3. name                        否        部门名称。长度限制为1~32个字符，字符不能包括\:*?”<>｜
4. name_en                        否        英文名称，需要在管理后台开启多语言支持才能生效。长度限制为1~32个字符，字符不能包括\:*?”<>｜
5. parentid                        否        父部门id
6. order                        否        在父部门中的次序值。order值大的排序靠前。有效的值范围是[0, 2^32)

请求返回结果：

[C#] 纯文本查看 复制代码

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

请求返回结果参数说明：

[C#] 纯文本查看 复制代码

参数                说明
errcode        返回码
errmsg        对返回码的文本描述内容

---

权限说明 ：

应用须拥有指定部门的管理权限。如若要移动部门，需要有新父部门的管理权限。
第三方仅通讯录应用可以调用。

注意，部门的最大层级为15层；部门总数不能超过3万个；每个部门下的节点不能超过3万个。