查询指定时间范围职务版本
- 接口支持查询出对象生效时间段在指定的start_date和end_date之间的版本（即：会查询出生效时间段和查询时间段有交集的版本）
- 接口支持对象版本相关字段的查询和返回（默认返回id和version_id）
Tip: 延迟说明：数据库主从延迟2s以内，即：直接创建对象后2s内调用此接口可能查询不到数据。
请求
| 项目 | 值 |
|---|---|
| HTTP URL | https://open.feishu.cn/open-apis/corehr/v2/jobs/query_multi_timeline |
| HTTP Method | POST |
| 接口频率限制 | 5 次/秒 |
| 支持的应用类型 | custom,isv |
| 权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用 开启任一权限即可 | corehr:job:read 获取职务信息 corehr:job:write 读写职务信息 |
| 字段权限要求 | > Tip: 该接口返回体中存在下列敏感字段，仅当开启对应的权限后才会返回；如果无需获取这些字段，则不建议申请 corehr:job.job_level:read 获取职务中的职级信息 |
请求头
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| Authorization | string | 是 | tenant_access_token 值格式："Bearer access_token" 示例值："Bearer t-7f1bcd13fc57d46bac21793a18e560" 了解更多：如何选择与获取 access token |
| Content-Type | string | 是 | 固定值："application/json; charset=utf-8" |
请求体
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
job_ids | string\[\] | 是 | 职务 ID 列表 - 可通过【批量查询职务】获取ID 示例值：["7094136522860922111"] 数据校验规则： - 长度范围： 1 ～ 10 |
start_date | string | 否 | 查询开始时间（包含），注意事项： - start_date 不能大于 end_date - 必填字段，无默认值 示例值："2024-01-01" 数据校验规则： - 长度范围： 10 ～ 10 字符 - 正则校验：`^((([0-9]{3}[1-9] |
end_date | string | 否 | 查询结束时间(不包含)，注意事项： - 必填字段，无默认值 示例值："2024-12-31" 数据校验规则： - 长度范围： 10 ～ 10 字符 - 正则校验：`^((([0-9]{3}[1-9] |
fields | string\[\] | 否 | 返回数据的字段列表，可选 - job_name：职务名称 - code：编码 - active：是否启用 - parent_job：（该字段无效，请忽略） - description：描述 - effective_date：当前版本生效日期 - expiration_date：当前版本失效日期 - job_title：职务头衔 - job_family：序列 - job_level：职级 - pathway：通道 - working_hours_type：工时制度 注意事项： - 为空时只能查询到ID 示例值：["job_name"] 数据校验规则： - 长度范围： 0 ～ 100 |
请求体示例
json
{
"job_ids": [
"7094136522860922111"
],
"start_date": "2024-01-01",
"end_date": "2024-12-31",
"fields": [
"job_name"
]
}响应
响应体
| 名称 | 类型 | 描述 |
|---|---|---|
code | int | 错误码，非 0 表示失败 |
msg | string | 错误描述 |
data | \- | - |
└ items | job_timeline\[\] | 职务信息 |
└ job_version_data | job_version_data\[\] | 职务版本信息 |
└ job_id | string | 职务 ID |
└ job_version_id | string | 职务版本 ID |
└ job_names | i18n\[\] | 职务名称 |
└ lang | string | 语言信息，中文：zh-CN，英文en-US |
└ value | string | 文本内容 |
└ effective_date | string | 当前版本生效日期 - 返回格式：YYYY-MM-DD （最小单位到日） - 日期范围:1900-01-01 ～9999-12-31 - 详情可以参考时间轴介绍 |
└ expiration_date | string | 当前版本失效日期 - 返回格式：YYYY-MM-DD （最小单位到日） - 日期范围:1900-01-01 ～9999-12-31 - 详情可以参考时间轴介绍 |
└ active | boolean | 是否启用 |
└ descriptions | i18n\[\] | 描述 |
└ lang | string | 语言信息，中文：zh-CN，英文en-US |
└ value | string | 文本内容 |
└ code | string | 编码 |
└ job_titles | i18n\[\] | 职务头衔 |
└ lang | string | 语言信息，中文：zh-CN，英文en-US |
└ value | string | 文本内容 |
└ job_family_ids | string\[\] | 序列ID - 可通过批量查询序列获取详情 |
└ job_level_ids | string\[\] | 职级ID - 可通过批量查询职级获取详情 字段权限要求： corehr:job.job_level:read 获取职务中的职级信息 |
└ pathway_id | string | 通道ID，详情可以参考【获取通道信息】 |
└ working_hours_type_id | string | 工时制度 ID，详细信息可通过【批量查询工时制度】接口查询获得 |
响应体示例
json
{
"code": 0,
"msg": "success",
"data": {
"items": [
{
"job_version_data": [
{
"job_id": "4719456877659520852",
"job_version_id": "7238516215202170412",
"job_names": [
{
"lang": "zh-CN",
"value": "软件工程师"
}
],
"effective_date": "2020-05-01",
"expiration_date": "2020-05-02",
"active": true,
"descriptions": [
{
"lang": "zh-CN",
"value": "负责后端开发"
}
],
"code": "BD38591",
"job_titles": [
{
"lang": "zh-CN",
"value": "高级"
}
],
"job_family_ids": [
"4719519211875096301"
],
"job_level_ids": [
"4719519212005299950"
],
"pathway_id": "4719519211875096301",
"working_hours_type_id": "6890452208593372679"
}
]
}
]
}
}错误码
| HTTP状态码 | 错误码 | 描述 | 排查建议 |
|---|---|---|---|
| 503 | 1161204 | Request timeout | 接口超时，可尝试重试。如果无法解决可以联系飞书人事 技术支持 |
| 429 | 1161604 | QPS over limit | 接口请求次数超过接口频率限制，可尝试降低请求频率 |