Asp.net【企业微信开发】部门管理（一）创建部门

范范

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

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

创建部门

---

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

请求参数包体实例：

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

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

请求包体参数说明：

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

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

返回结果：

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

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

返回参数说明：

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

参数        说明
errcode        返回码
errmsg        对返回码的文本描述内容
id        创建的部门id

---

权限说明：

第三方仅通讯录应用可以调用。

注意，部门的最大层级为15层；部门总数不能超过3万个；每个部门下的节点不能超过3万个。建议保证创建的部门和对应部门成员是串行化处理。