智慧硬件开发 服务端API 通讯录管理 部门管理 更新部门
更新部门

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

请求包体(如果非必须的字段未指定,则不更新该字段):

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

参数说明:

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

 

* 权限说明 :*

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

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

返回结果:

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

参数说明:

参数说明
errcode返回码
errmsg对返回码的文本描述内容
上一篇
创建部门
下一篇
删除部门