批量获取员工花名册信息

GET {{base_url}}/ehr/v1/employees

根据员工飞书用户 ID / 员工状态 / 雇员类型等搜索条件 ,批量获取员工花名册字段信息。字段包括「系统标准字段 / systemfields」和「自定义字段 / customfields」

参考接口文档:批量获取员工花名册信息

Request Params

KeyDatatypeRequiredDescription
viewstring返回数据类型
statusnumber员工状态,不传代表查询所有员工状态

实际在职 = 2&4

可同时查询多个状态的记录,如 status=2&status=4 | | type | number | | 雇员类型,不传代表查询所有雇员类型 | | start_time | number | | 查询开始时间(创建时间 >= 此时间) | | end_time | number | | 查询结束时间(创建时间 <= 此时间) | | user_id_type | string | | 用户 ID 类型。可选值:open_id、union_id、user_id | | user_ids | string | | user_id、open_id 或 union_id,默认为 open_id。

如果传入的值不是 open_id,需要一并传入 user_id_type 参数。

可一次查询多个 id 的用户,例如:user_ids=ou_8ebd4f35d7101ffdeb4771d7c8ec517e&user_ids=ou_7abc4f35d7101ffdeb4771dabcde

用户相关的 ID 概念 | | page_token | number | | 分页标记,第一次请求不填,表示从头开始遍历;分页查询结果还有更多项时会同时返回新的 page_token,下次遍历可采用该 page_token 获取查询结果 | | page_size | number | | 分页大小 |