管理部门

来自企业号开发者接口文档
跳转至: 导航搜索

创建部门

  • 请求说明

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值小的排序靠前。