部门接口

class dingtalk.client.api.Department(client=None)

create(department_data)

创建部门

参数:department_data – 部门信息 返回:创建的部门id

delete(_id)

删除部门

参数:_id – 部门id。（注：不能删除根部门；不能删除含有子部门、成员的部门） 返回:

get(_id, lang='zh_CN')

获取部门详情

参数:

• _id – 部门id
• lang – 通讯录语言(默认zh_CN，未来会支持en_US)

返回:

部门列表数据。以部门的order字段从小到大排列

list(_id=1, lang='zh_CN', fetch_child=False)

获取部门列表

参数:

• _id – 父部门id(如果不传，默认部门为根部门，根部门ID为1)
• lang – 通讯录语言(默认zh_CN，未来会支持en_US)
• fetch_child – 是否递归部门的全部子部门，ISV微应用固定传递false。

返回:

部门列表数据。以部门的order字段从小到大排列

list_ids(_id=1)

获取子部门ID列表

参数:_id – 父部门id(如果不传，默认部门为根部门，根部门ID为1) 返回:子部门ID列表数据

list_parent_depts(user_id)

查询指定用户的所有上级父部门路径

参数:user_id – 希望查询的用户的id 返回:按顺序依次为其所有父部门的ID，直到根部门

list_parent_depts_by_dept(_id)

查询部门的所有上级父部门路径

参数:_id – 希望查询的部门的id，包含查询的部门本身 返回:该部门的所有父部门id列表

update(department_data)

更新部门

参数:department_data – 部门信息 返回:已经更新的部门id