苏飞论坛

标题: Asp.net【企业微信开发】部门管理（一）创建部门 [打印本页]

---

作者: 范范    时间: 2021-9-6 12:02
标题: 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万个。建议保证创建的部门和对应部门成员是串行化处理。

---

欢迎光临 苏飞论坛 (http://www.sufeinet.com/)

Powered by Discuz! X3.4