查询当前生效信息发生变更的自定义组织

查询指定时间范围内当前生效信息发生变更的自定义组织，即只有部门当前生效版本的生效时间在查询时间范围内，才返回该自定义组织id

Tip: - 默认排序条件：默认先按照组织记录 ID 增序排序， 便于滚动查询

• 使用滚动查询而非分页查询，是为了防止大批量获取数据时，深分页导致超时

Warning: - 时间窗支持大范围查询，限定查询范围在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点之后可查询到。

请求

项目	值
HTTP URL	https://open.feishu.cn/open-apis/corehr/v2/custom_orgs/query_recent_change
HTTP Method	GET
接口频率限制	5 次/秒
支持的应用类型	custom,isv
权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用 开启任一权限即可	corehr:custom_org:read 获取自定义组织信息 corehr:custom_org:write 读写自定义组织信息

请求头

名称	类型	必填	描述
Authorization	string	是	tenant_access_token 值格式："Bearer access_token" 示例值："Bearer t-7f1bcd13fc57d46bac21793a18e560" 了解更多：如何选择与获取 access token

查询参数

名称	类型	必填	描述
page_size	int	是	分页大小，最大 2000 示例值：100 数据校验规则： - 取值范围：1 ～ 2000
page_token	string	否	分页标记，第一次请求不填，表示从头开始遍历；分页查询结果还有更多项时会同时返回新的 page_token，下次遍历可采用该 page_token 获取查询结果 示例值：6891251722631890445
object_api_name	string	是	组织类型编码，可在「飞书人事-设置-组织设置」中相应的自定义组织目录下查看 示例值：custom_org_01
start_date	string	是	查询的开始时间，支持"yyyy-MM-dd HH:MM:SS" 示例值：2024-01-01 00:00:00
end_date	string	是	查询的结束时间，格式 "yyyy-MM-dd HH:MM:SS" 示例值：2024-04-01 00:00:00

响应

响应体

名称	类型	描述
code	int	错误码，非 0 表示失败
msg	string	错误描述
data	\-	-
└ custom_org_ids	string\[\]	自定义组织 ID 列表， 其中包含新建、更新以及删除的 ID 列表。 - 非删除的数据，可通过查询自定义组织信息 获取详情
└ page_token	string	分页标记，当 has_more 为 true 时，会同时返回新的 page_token，否则不返回 page_token
└ has_more	boolean	是否还有更多项
└ deleted_custom_org_ids	string\[\]	目标查询时间范围内被删除的自定义组织列表， 该列表是 department_ids 的子集，便于获取在指定的[start_date, end_date+1) 的范围内被删除的自定义组织 IDs。 - 由于对应的自定义组织已经被删除，无法通过 ID 查询到历史数据。

响应体示例

{
    "code": 0,
    "msg": "success",
    "data": {
        "custom_org_ids": [
            "7094136522860922111"
        ],
        "page_token": "eVQrYzJBNDNONlk4VFZBZVlSdzlKdFJ4bVVHVExENDNKVHoxaVdiVnViQT0=",
        "has_more": true,
        "deleted_custom_org_ids": [
            "7094136522860922111"
        ]
    }
}

错误码

HTTP状态码	错误码	描述	排查建议
400	1160107	param is invalid	请检查日期格式，以及查询开始时间与结束时间的范围不超过 90 天