苏飞论坛

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

作者: 范范 时间: 2021-9-7 11:25
标题: 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万个。

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