请求方式: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~64个UTF-8字符,字符不能包括\:*?"<>| |
name_en | 否 | 英文名称,需要在管理后台开启多语言支持才能生效。长度限制为1~64个字符,字符不能包括\:*?"<>| |
parentid | 否 | 父部门id |
order | 否 | 在父部门中的次序值。order值大的排序靠前。有效的值范围是[0, 2^32) |
* 权限说明 :*
应用须拥有指定部门的管理权限。如若要移动部门,需要有新父部门的管理权限。
第三方仅通讯录应用可以调用。
注意,部门的最大层级为15层;部门总数不能超过3万个;每个部门下的节点不能超过3万个。
返回结果:
{
"errcode": 0,
"errmsg": "updated"
}
参数说明:
参数 | 说明 |
---|---|
errcode | 返回码 |
errmsg | 对返回码的文本描述内容 |