管理部门

创建部门

• 请求说明

Https请求方式: POST

https://qyapi.weixin.qq.com/cgi-bin/department/create?access_token=ACCESS_TOKEN

请求包结构体为:

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

• 参数说明

参数	必须	说明
access_token	是	调用接口凭证
name	是	部门名称。长度限制为32个字（汉字或英文字母），字符不能包括\:*?"<>｜
parentid	是	父亲部门id。根部门id为1
order	否	在父部门中的次序值。order值小的排序靠前。
id	否	部门id，整型。指定时必须大于1，不指定时则自动生成

• 权限说明

管理组须拥有父部门的管理权限。

• 返回结果

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

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

更新部门

• 请求说明

Https请求方式: POST

https://qyapi.weixin.qq.com/cgi-bin/department/update?access_token=ACCESS_TOKEN

请求包结构体为（如果非必须的字段未指定，则不更新该字段之前的设置值）:

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

• 参数说明

参数	必须	说明
access_token	是	调用接口凭证
id	是	部门id
name	否	更新的部门名称。长度限制为32个字（汉字或英文字母），字符不能包括\:*?"<>｜。修改部门名称时指定该参数
parentid	否	父亲部门id。根部门id为1
order	否	在父部门中的次序值。order值小的排序靠前。

• 权限说明

管理组须拥有指定部门的管理权限。

• 返回结果

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

删除部门

• 请求说明

Https请求方式: GET

https://qyapi.weixin.qq.com/cgi-bin/department/delete?access_token=ACCESS_TOKEN&id=ID

• 参数说明

参数	必须	说明
access_token	是	调用接口凭证
id	是	部门id。（注：不能删除根部门；不能删除含有子部门、成员的部门）

• 权限说明

管理组须拥有指定部门的管理权限。

• 返回结果

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

获取部门列表

• 请求说明

Https请求方式: GET

https://qyapi.weixin.qq.com/cgi-bin/department/list?access_token=ACCESS_TOKEN&id=ID

• 参数说明

参数	必须	说明
access_token	是	调用接口凭证
id	否	部门id。获取指定部门及其下的子部门

• 权限说明

管理组须拥有指定部门的查看权限。

• 返回结果

{
   "errcode": 0,
   "errmsg": "ok",
   "department": [
       {
           "id": 2,
           "name": "广州研发中心",
           "parentid": 1,
           "order": 10
       },
       {
           "id": 3
           "name": "邮箱产品部",
           "parentid": 2,
           "order": 40
       }
   ]
}

参数	说明
errcode	返回码
errmsg	对返回码的文本描述内容
department	部门列表数据。以部门的order字段从小到大排列
id	部门id
name	部门名称
parentid	父亲部门id。根部门为1
order	在父部门中的次序值。order值小的排序靠前。