public class Department extends Object
| 构造器和说明 |
|---|
Department(Config config) |
| 限定符和类型 | 方法和说明 | ||||
|---|---|---|---|---|---|
BatchGetDepartmentResp |
batchGet(BatchGetDepartmentReq req)
批量查询部门,批量查询部门信息,**该接口只返回部门当前内容**。
|
||||
BatchGetDepartmentResp |
batchGet(BatchGetDepartmentReq req,
RequestOptions reqOptions)
批量查询部门,批量查询部门信息,**该接口只返回部门当前内容**。
|
||||
DeleteDepartmentResp |
delete(DeleteDepartmentReq req)
删除部门,可以通过该接口通过部门ID删除一个部门记录,带数据行权限判权
删除后无法恢复, 并且在系统中无法查看到对应部门信息,请谨慎操作。
|
||||
DeleteDepartmentResp |
delete(DeleteDepartmentReq req,
RequestOptions reqOptions)
删除部门,可以通过该接口通过部门ID删除一个部门记录,带数据行权限判权
删除后无法恢复, 并且在系统中无法查看到对应部门信息,请谨慎操作。
|
||||
ParentsDepartmentResp |
parents(ParentsDepartmentReq req)
获取父部门信息,该接口用来递归获取部门的父部门信息,并按照由子到父的顺序返回有权限的父部门信息列表。
|
||||
ParentsDepartmentResp |
parents(ParentsDepartmentReq req,
RequestOptions reqOptions)
获取父部门信息,该接口用来递归获取部门的父部门信息,并按照由子到父的顺序返回有权限的父部门信息列表。
|
||||
PatchDepartmentResp |
patch(PatchDepartmentReq req)
更新部门,更新部门,支持数据行权限判权
官网API文档链接:
PatchDepartmentResppatch(PatchDepartmentReq req,
RequestOptions reqOptions)
更新部门,更新部门,支持数据行权限判权
官网API文档链接:
QueryMultiTimelineDepartmentRespqueryMultiTimeline(QueryMultiTimelineDepartmentReq req)
批量查询部门版本信息,根据部门ID列表,批量查询开始结束时间内的所有部门版本信息,含部门名称、部门类型、上级、编码、负责人、是否启用、描述等信息
- 延迟说明:数据库主从延迟 2s 以内,即:直接创建部门后2s内调用此接口可能查询不到数据。
| ||||
QueryMultiTimelineDepartmentResp |
queryMultiTimeline(QueryMultiTimelineDepartmentReq req,
RequestOptions reqOptions)
批量查询部门版本信息,根据部门ID列表,批量查询开始结束时间内的所有部门版本信息,含部门名称、部门类型、上级、编码、负责人、是否启用、描述等信息
- 延迟说明:数据库主从延迟 2s 以内,即:直接创建部门后2s内调用此接口可能查询不到数据。
|
||||
QueryOperationLogsDepartmentResp |
queryOperationLogs(QueryOperationLogsDepartmentReq req)
批量查询部门操作日志,批量查询指定时间范围内的部门操作日志
-
时间窗支持大范围查询,限定查询范围在366天以内,例如要查询2020年1月1日至2023年1月1日的数据,建议分成两次查询,分别为2020年1月1日至2021年1月1日,2022年1月2日至2023年1月1日,不建议查询大时间范围数据;-
支持查询批量部门的操作日志,限定查询最大部门数为100,查询部门数量大于100时,建议分批查询;;- 默认排序条件:默认以操作时间倒序排序;-
仅支持查询部门基础字段变更的操作日志,对于角色字段变更的操作日志查询功能待上线; ;
官网API文档链接:
QueryOperationLogsDepartmentRespqueryOperationLogs(QueryOperationLogsDepartmentReq req,
RequestOptions reqOptions)
批量查询部门操作日志,批量查询指定时间范围内的部门操作日志
-
时间窗支持大范围查询,限定查询范围在366天以内,例如要查询2020年1月1日至2023年1月1日的数据,建议分成两次查询,分别为2020年1月1日至2021年1月1日,2022年1月2日至2023年1月1日,不建议查询大时间范围数据;-
支持查询批量部门的操作日志,限定查询最大部门数为100,查询部门数量大于100时,建议分批查询;;- 默认排序条件:默认以操作时间倒序排序;-
仅支持查询部门基础字段变更的操作日志,对于角色字段变更的操作日志查询功能待上线; ;
官网API文档链接:
QueryRecentChangeDepartmentRespqueryRecentChange(QueryRecentChangeDepartmentReq req)
查询指定时间范围内当前生效信息发生变更的部门,查询指定时间范围内当前生效信息发生变更的部门,即只有部门当前生效版本的生效时间在查询时间范围内,才返回该部门id
-
时间窗支持大范围查询,限定查询范围在90天以内,例如要查询2020年1月1日至2020年6月30日的数据,建议分成两次查询,分别为2020年1月1日至2020年3月31日,2020年4月1日至2020年6月30日,不建议查询大时间范围数据
;- 未来生效的版本数据,会在生效日期当天凌晨产生变更事件。
| ||||
QueryRecentChangeDepartmentResp |
queryRecentChange(QueryRecentChangeDepartmentReq req,
RequestOptions reqOptions)
查询指定时间范围内当前生效信息发生变更的部门,查询指定时间范围内当前生效信息发生变更的部门,即只有部门当前生效版本的生效时间在查询时间范围内,才返回该部门id
-
时间窗支持大范围查询,限定查询范围在90天以内,例如要查询2020年1月1日至2020年6月30日的数据,建议分成两次查询,分别为2020年1月1日至2020年3月31日,2020年4月1日至2020年6月30日,不建议查询大时间范围数据
;- 未来生效的版本数据,会在生效日期当天凌晨产生变更事件。
|
||||
QueryTimelineDepartmentResp |
queryTimeline(QueryTimelineDepartmentReq req)
查询指定日期的部门基本信息,查询指定生效的部门基本信息,含部门名称、部门类型、上级、编码、负责人、是否启用、描述等信息
延迟说明:数据库主从延迟 2s 以内,即:直接创建部门后2s内调用此接口可能查询不到数据。
|
||||
QueryTimelineDepartmentResp |
queryTimeline(QueryTimelineDepartmentReq req,
RequestOptions reqOptions)
查询指定日期的部门基本信息,查询指定生效的部门基本信息,含部门名称、部门类型、上级、编码、负责人、是否启用、描述等信息
延迟说明:数据库主从延迟 2s 以内,即:直接创建部门后2s内调用此接口可能查询不到数据。
|
||||
SearchDepartmentResp |
search(SearchDepartmentReq req)
搜索部门信息,该接口支持通过部门id、上级部门ID、部门负责人、名称、编码字段批量搜索当天的部门详情信息,包括部门包含的名称、描述、启用状态等。
|
||||
SearchDepartmentResp |
search(SearchDepartmentReq req,
RequestOptions reqOptions)
搜索部门信息,该接口支持通过部门id、上级部门ID、部门负责人、名称、编码字段批量搜索当天的部门详情信息,包括部门包含的名称、描述、启用状态等。
|
||||
TreeDepartmentResp |
tree(TreeDepartmentReq req)
查询指定生效日期的部门架构树,支持传入部门ID(不传默认根部门),任意日期(不传默认当前日期)。
|
||||
TreeDepartmentResp |
tree(TreeDepartmentReq req,
RequestOptions reqOptions)
查询指定生效日期的部门架构树,支持传入部门ID(不传默认根部门),任意日期(不传默认当前日期)。
|
public Department(Config config)
public BatchGetDepartmentResp batchGet(BatchGetDepartmentReq req, RequestOptions reqOptions) throws Exception
- 延迟说明:数据库主从延迟 2 秒以内,即:直接创建部门后 2 秒内调用此接口可能查询不到数据。;- 对比历史版本[批量查询部门](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/department/list);接口,本版本增加了敏感字段权限要求,并使用了 POST HTTP 请求。;;看权限 ;
Exceptionpublic BatchGetDepartmentResp batchGet(BatchGetDepartmentReq req) throws Exception
- 延迟说明:数据库主从延迟 2 秒以内,即:直接创建部门后 2 秒内调用此接口可能查询不到数据。;- 对比历史版本[批量查询部门](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/department/list);接口,本版本增加了敏感字段权限要求,并使用了 POST HTTP 请求。;;看权限 ;
Exceptionpublic DeleteDepartmentResp delete(DeleteDepartmentReq req, RequestOptions reqOptions) throws Exception
删除后无法恢复, 并且在系统中无法查看到对应部门信息,请谨慎操作。;;该接口为 V2 版本接口。要查看旧版 V1 接口,参考:[【删除部门】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/department/delete) ;
Exceptionpublic DeleteDepartmentResp delete(DeleteDepartmentReq req) throws Exception
删除后无法恢复, 并且在系统中无法查看到对应部门信息,请谨慎操作。;;该接口为 V2 版本接口。要查看旧版 V1 接口,参考:[【删除部门】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/department/delete) ;
Exceptionpublic ParentsDepartmentResp parents(ParentsDepartmentReq req, RequestOptions reqOptions) throws Exception
延迟说明:该接口返回的数据延迟 10s内,即:直接部门上级或者上上级部门发生变化后,10s后才能查询到最新数据。 ;
Exceptionpublic ParentsDepartmentResp parents(ParentsDepartmentReq req) throws Exception
延迟说明:该接口返回的数据延迟 10s内,即:直接部门上级或者上上级部门发生变化后,10s后才能查询到最新数据。 ;
Exceptionpublic PatchDepartmentResp patch(PatchDepartmentReq req, RequestOptions reqOptions) throws Exception
Exceptionpublic PatchDepartmentResp patch(PatchDepartmentReq req) throws Exception
Exceptionpublic QueryMultiTimelineDepartmentResp queryMultiTimeline(QueryMultiTimelineDepartmentReq req, RequestOptions reqOptions) throws Exception
- 延迟说明:数据库主从延迟 2s 以内,即:直接创建部门后2s内调用此接口可能查询不到数据。 ;
Exceptionpublic QueryMultiTimelineDepartmentResp queryMultiTimeline(QueryMultiTimelineDepartmentReq req) throws Exception
- 延迟说明:数据库主从延迟 2s 以内,即:直接创建部门后2s内调用此接口可能查询不到数据。 ;
Exceptionpublic QueryOperationLogsDepartmentResp queryOperationLogs(QueryOperationLogsDepartmentReq req, RequestOptions reqOptions) throws Exception
- 时间窗支持大范围查询,限定查询范围在366天以内,例如要查询2020年1月1日至2023年1月1日的数据,建议分成两次查询,分别为2020年1月1日至2021年1月1日,2022年1月2日至2023年1月1日,不建议查询大时间范围数据;- 支持查询批量部门的操作日志,限定查询最大部门数为100,查询部门数量大于100时,建议分批查询;;- 默认排序条件:默认以操作时间倒序排序;- 仅支持查询部门基础字段变更的操作日志,对于角色字段变更的操作日志查询功能待上线; ;
Exceptionpublic QueryOperationLogsDepartmentResp queryOperationLogs(QueryOperationLogsDepartmentReq req) throws Exception
- 时间窗支持大范围查询,限定查询范围在366天以内,例如要查询2020年1月1日至2023年1月1日的数据,建议分成两次查询,分别为2020年1月1日至2021年1月1日,2022年1月2日至2023年1月1日,不建议查询大时间范围数据;- 支持查询批量部门的操作日志,限定查询最大部门数为100,查询部门数量大于100时,建议分批查询;;- 默认排序条件:默认以操作时间倒序排序;- 仅支持查询部门基础字段变更的操作日志,对于角色字段变更的操作日志查询功能待上线; ;
Exceptionpublic QueryRecentChangeDepartmentResp queryRecentChange(QueryRecentChangeDepartmentReq req, RequestOptions reqOptions) throws Exception
- 时间窗支持大范围查询,限定查询范围在90天以内,例如要查询2020年1月1日至2020年6月30日的数据,建议分成两次查询,分别为2020年1月1日至2020年3月31日,2020年4月1日至2020年6月30日,不建议查询大时间范围数据 ;- 未来生效的版本数据,会在生效日期当天凌晨产生变更事件。例如:今天为1月1日,新建部门 1月10日生效,则1月10日凌晨 1点之后可查询到。;;- 默认排序条件:默认先按照组织记录 ID 增序排序, 便于滚动查询;- 使用滚动查询而非分页查询,是为了防止大批量获取数据时,深分页导致超时 ;
Exceptionpublic QueryRecentChangeDepartmentResp queryRecentChange(QueryRecentChangeDepartmentReq req) throws Exception
- 时间窗支持大范围查询,限定查询范围在90天以内,例如要查询2020年1月1日至2020年6月30日的数据,建议分成两次查询,分别为2020年1月1日至2020年3月31日,2020年4月1日至2020年6月30日,不建议查询大时间范围数据 ;- 未来生效的版本数据,会在生效日期当天凌晨产生变更事件。例如:今天为1月1日,新建部门 1月10日生效,则1月10日凌晨 1点之后可查询到。;;- 默认排序条件:默认先按照组织记录 ID 增序排序, 便于滚动查询;- 使用滚动查询而非分页查询,是为了防止大批量获取数据时,深分页导致超时 ;
Exceptionpublic QueryTimelineDepartmentResp queryTimeline(QueryTimelineDepartmentReq req, RequestOptions reqOptions) throws Exception
延迟说明:数据库主从延迟 2s 以内,即:直接创建部门后2s内调用此接口可能查询不到数据。 ;
Exceptionpublic QueryTimelineDepartmentResp queryTimeline(QueryTimelineDepartmentReq req) throws Exception
延迟说明:数据库主从延迟 2s 以内,即:直接创建部门后2s内调用此接口可能查询不到数据。 ;
Exceptionpublic SearchDepartmentResp search(SearchDepartmentReq req, RequestOptions reqOptions) throws Exception
延迟说明:搜索同步延迟 10s 以内,即:直接创建部门后10s内调用此接口可能查询不到数据。 ;
Exceptionpublic SearchDepartmentResp search(SearchDepartmentReq req) throws Exception
延迟说明:搜索同步延迟 10s 以内,即:直接创建部门后10s内调用此接口可能查询不到数据。 ;
Exceptionpublic TreeDepartmentResp tree(TreeDepartmentReq req, RequestOptions reqOptions) throws Exception
- 延迟说明:该数据同步延迟 10s 以内,即:直接创建/更新对象后10s内调用此接口可能查询不到数据,部门上下级关系变化10s内可能查询不到最新数据。;- 如果对数据延迟较为敏感的场景,可以考虑定期or延迟调用该接口,或者走[批量查询部门V2](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/department/batch_get) 逐级查询组织架构 ;
Exceptionpublic TreeDepartmentResp tree(TreeDepartmentReq req) throws Exception
- 延迟说明:该数据同步延迟 10s 以内,即:直接创建/更新对象后10s内调用此接口可能查询不到数据,部门上下级关系变化10s内可能查询不到最新数据。;- 如果对数据延迟较为敏感的场景,可以考虑定期or延迟调用该接口,或者走[批量查询部门V2](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/department/batch_get) 逐级查询组织架构 ;
ExceptionCopyright © 2026. All rights reserved.