查询部门 / 地点的 HRBP / 属地 BP

通过部门或工作地点，查询对应的 HRBP / 属地 BP，返回的信息中包含BP的员工ID、部门ID、属地ID等信息。

请求

项目	值
HTTP URL	https://open.feishu.cn/open-apis/corehr/v1/security_groups/query
HTTP Method	POST
接口频率限制	1000 次/分钟、50 次/秒
支持的应用类型	custom,isv
权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用 开启任一权限即可	corehr:authorization:read 获取用户授权数据 corehr:corehr:readonly 获取核心人事信息 corehr:corehr 更新核心人事信息 corehr:authorization.bp:read 查询部门/地点的HRBP/属地BP

请求头

名称	类型	必填	描述
Authorization	string	是	tenant_access_token 值格式："Bearer access_token" 示例值："Bearer t-7f1bcd13fc57d46bac21793a18e560" 了解更多：如何选择与获取 access token
Content-Type	string	是	固定值："application/json; charset=utf-8"

查询参数

名称	类型	必填	描述
department_id_type	string	否	此次调用中使用的部门 ID 类型 示例值：people_corehr_department_id 可选值有： - open_department_id: 以 open_department_id 来标识部门 - department_id: 以 department_id 来标识部门 - people_corehr_department_id: 以 people_corehr_department_id 来标识部门 默认值：people_corehr_department_id

请求体

名称	类型	必填	描述
item_list	bp_role_organization\[\]	是	角色列表，一次最多支持查询 50 个
└ role_key	string	是	角色类型的唯一标识 - HRBP：与部门有关，role_key 固定为 「hrbp」 - 属地 BP：与部门、工作地点有关，role_key 固定为 「location_bp」 示例值："location_bp"
└ department_id	string	是	部门 ID，查询 HRBP 需输入部门 ID，ID类型与department_id_type的取值意义一致。 > 可以使用 ID转换服务换取 ==department_id== > 部门id也可通过搜索部门信息接口获取。 示例值："7063072995761456670"
└ work_location_id	string	否	工作地点 ID，查询属地 BP 需要输入部门 ID 与 工作地点 ID > 可从批量查询地点接口获取，或者在「飞书人事-组织管理-地点」中查看。 示例值："6892687221355185677"
updated_at_gte	string	否	授权时间大于 示例值："1729773628"
updated_at_lte	string	否	授权时间小于 示例值："1729773628"

请求体示例

{
    "item_list": [
        {
            "role_key": "location_bp",
            "department_id": "7063072995761456670",
            "work_location_id": "6892687221355185677"
        }
    ],
    "updated_at_gte": "1729773628",
    "updated_at_lte": "1729773628"
}

响应

响应体

名称	类型	描述
code	int	错误码，非 0 表示失败
msg	string	错误描述
data	\-	-
└ hrbp_list	hrbp\[\]	HRBP/属地 BP 信息
└ employment_id_list	string\[\]	HRBP/属地 BP 的雇员ID ： 对于 HRBP 而言，若入参的部门没有找到对应的 HRBP，将向上找寻，即向其上级部门取对应的 HRBP，且同一部门可能有多个 HRBP； 对于 属地 BP 而言，若入参的部门和地点没有找到对应的属地 BP，将优先拿地点向上找寻，即向其上级地点取对应的属地 BP > 如想获取BP的详细信息，可通过搜索员工信息接口获取。
└ department_id	string	部门 ID > 如想获取部门详细信息，可通过搜索部门信息接口获取。
└ work_location_id	string	工作地点 ID

响应体示例

{
    "code": 0,
    "msg": "success",
    "data": {
        "hrbp_list": [
            {
                "employment_id_list": [
                    "['7063072995761456670']"
                ],
                "department_id": "7063072995761456670",
                "work_location_id": "6892687221355185677"
            }
        ]
    }
}

错误码

HTTP状态码	错误码	描述	排查建议
400	1161403	Incorrect parameter length	请检查List，Map等容器类型参数
400	1161404	Missing or invalid parameter	请检查参数是否有效
400	1161406	Parameter exceeds the optional range	参数超过可选范围，请检查枚举类参数的可选范围
500	1161501	System internal error	请参考详细错误信息，如有问题请咨询技术支持