管理部门
来自企业号开发者接口文档
创建部门
- 请求说明
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值小的排序靠前。 |