批量获取员工花名册信息
GET {{base_url}}/ehr/v1/employees
根据员工飞书用户 ID / 员工状态 / 雇员类型等搜索条件 ,批量获取员工花名册字段信息。字段包括「系统标准字段 / systemfields」和「自定义字段 / customfields」
参考接口文档:批量获取员工花名册信息
Request Params
Key | Datatype | Required | Description |
---|---|---|---|
view | string | 返回数据类型 | |
status | number | 员工状态,不传代表查询所有员工状态 |
实际在职 = 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 | | 分页大小 |