/ 
QQ-weixin-work-v0.10
River stage zero No dependents
/ QQ::weixin::work::department

Name

QQ::weixin::work::department

DESCRIPTION

通讯录管理->部门管理

FUNCTION

create(access_token, hash);

创建部门 最后更新：2023/08/15

SYNOPSIS

https://developer.work.weixin.qq.com/document/path/90205

请求说明

请求包结构体为：

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

参数说明

参数	            必须	说明
access_token	是	调用接口凭证
name	是	部门名称。长度限制为1~32个字符，字符不能包括\:?”<>｜
name_en	否	英文名称，需要在管理后台开启多语言支持才能生效。长度限制为1~32个字符，字符不能包括\:?”<>｜
parentid	是	父部门id，32位整型
order	否	在父部门中的次序值。order值大的排序靠前。有效的值范围是[0, 2^32)
id	否	部门id，32位整型，指定时必须大于1。若不填该参数，将自动生成id

权限说明

第三方仅通讯录应用可以调用。

注意，部门的最大层级为15层；部门总数不能超过3万个；每个部门下的节点不能超过3万个。建议保证创建的部门和对应部门成员是串行化处理。

RETURN 返回结果

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

RETURN 参数说明

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

update(access_token, hash);

更新部门 最后更新：2023/08/15

SYNOPSIS

https://developer.work.weixin.qq.com/document/path/90206

请求说明：

请求包体（如果非必须的字段未指定，则不更新该字段）:

{
   "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万个。

RETURN 返回结果

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

RETURN 参数说明

参数	    说明
errcode	返回码
errmsg	对返回码的文本描述内容

delete(access_token, id);

删除部门 最后更新：2020/03/30

SYNOPSIS

https://developer.work.weixin.qq.com/document/path/90207

请求说明：

参数说明：

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

权限说明

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

第三方仅通讯录应用可以调用。

RETURN 返回结果

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

RETURN 参数说明

参数	    说明
errcode	返回码
errmsg	对返回码的文本描述内容

list(access_token, id);

获取部门列表 最后更新：2022/08/05

SYNOPSIS

https://developer.work.weixin.qq.com/document/path/90208

请求说明：

注：该接口性能较低，建议换用获取子部门ID列表与获取单个部门详情

参数说明：

参数	            必须	说明
access_token	是	调用接口凭证
id	          否	部门id。获取指定部门及其下的子部门。 如果不填，默认获取全量组织架构

权限说明

只能拉取token对应的应用的权限范围内的部门列表

RETURN 返回结果

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

RETURN 参数说明

    参数	        说明
    errcode	返回码
	errmsg	对返回码的文本描述内容
	department	部门列表数据。
	id	创建的部门id
	name	部门名称，代开发自建应用需要管理员授权才返回；此字段从2019年12月30日起，对新创建第三方应用不再返回，2020年6月30日起，对所有历史第三方应用不再返回name，返回的name字段使用id代替，后续第三方仅通讯录应用可获取，未返回名称的情况需要通过通讯录展示组件来展示部门名称
	name_en	英文名称，此字段从2019年12月30日起，对新创建第三方应用不再返回，2020年6月30日起，对所有历史第三方应用不再返回该字段
	department_leader	部门负责人的UserID；第三方仅通讯录应用可获取
	parentid	父部门id。根部门为1
	order	在父部门中的次序值。order值大的排序靠前。值范围是[0, 2^32)

simplelist(access_token, id);

获取子部门ID列表 最后更新：2023/09/06

SYNOPSIS

https://developer.work.weixin.qq.com/document/path/95350

请求说明：

参数说明：

参数	            必须	说明
access_token	是	调用接口凭证
id	          否	部门id。获取指定部门及其下的子部门（以及子部门的子部门等等，递归）。 如果不填，默认获取全量组织架构

权限说明

应用类型	权限说明
第三方普通应用	若企业授权了“组织架构信息”权限，可获取企业所有部门id; 若未授权“组织架构信息”权限，只能拉取token对应的应用的权限范围内的部门列表
第三方通讯录应用	可获取企业所有部门id
代开发自建应用	只能拉取token对应的应用的权限范围内的部门列表
普通自建应用	只能拉取token对应的应用的权限范围内的部门列表
通讯录同步助手	可获取企业所有部门id

RETURN 返回结果

    {
	   "errcode": 0,
	   "errmsg": "ok",
	   "department_id": [
		   {
			   "id": 2,
			   "parentid": 1,
			   "order": 10
		   },
		   {
			   "id": 3,
			   "parentid": 2,
			   "order": 40
		   }
	   ]
	}

RETURN 参数说明

    参数	        说明
    errcode	返回码
	errmsg	对返回码的文本描述内容
	department_id	部门列表数据。
	id	创建的部门id
	parentid	父部门id。根部门为1。
	order	在父部门中的次序值。order值大的排序靠前。值范围是[0, 2^32)。

get(access_token, id);

获取单个部门详情 最后更新：2023/09/06

SYNOPSIS

https://developer.work.weixin.qq.com/document/path/95351

请求说明：

参数说明：

参数	            必须	说明
access_token	是	调用接口凭证
id	是	部门id。

权限说明

应用类型	权限说明
第三方普通应用	若企业授权了“组织架构信息”权限，可获取企业所有部门ID、部门负责人、父部门ID; 若未授权“组织架构信息”权限，只能拉取token对应的应用的可见范围内部门详情
第三方通讯录应用	可获取企业所有部门详情，部门名字除外
代开发自建应用	若企业授权了“组织架构信息”-“部门及父部门ID、部门负责人”权限，可获取企业所有部门id; 若未授权“组织架构信息”-“部门及父部门ID、部门负责人”权限，只能拉取token对应的应用的权限范围内的部门列表
普通自建应用	只能拉取token对应的应用的权限范围内的部门详情
通讯录同步助手	可获取企业所有部门详情

RETURN 返回结果

    {
	   "errcode": 0,
	   "errmsg": "ok",
	   "department":
		   {
			   "id": 2,
			   "name": "广州研发中心",
			   "name_en": "RDGZ",
			   "department_leader":["zhangsan","lisi"],
			   "parentid": 1,
			   "order": 10
		   }
	}

RETURN 参数说明

    参数	        说明
    errcode	返回码
	errmsg	对返回码的文本描述内容
	department	部门详情。
	id	部门id
	name	部门名称，代开发自建应用需要管理员授权才返回；第三方不可获取，需要通过通讯录展示组件来展示部门名称
	name_en	部门英文名称，代开发自建应用需要管理员授权才返回；第三方不可获取，需要通过通讯录展示组件来展示部门名称
	department_leader	部门负责人的UserID，返回在应用可见范围内的部门负责人列表；第三方仅通讯录应用或者授权了“组织架构信息-应用可获取企业的部门组织架构信息-部门负责人”的第三方应用可获取
	parentid	父部门id。根部门为1。
	order	在父部门中的次序值。order值大的排序靠前。值范围是[0, 2^32)