飞书开放平台 Server API 文档

主题

查询单个任职信息 ​

根据 ID 查询当前生效的主任职记录。所有主任职记录中只有一条记录版本当前生效

Tip: 当前接口为历史版本。推荐使用新版接口，详情参见批量查询员工任职信息、获取任职信息列表。

请求 ​

项目值
HTTP URLhttps://open.feishu.cn/open-apis/corehr/v1/job_datas/:job_data_id
HTTP MethodGET
接口频率限制1000 次/分钟、50 次/秒
支持的应用类型custom,isv
权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用 开启任一权限即可corehr:corehr:readonly 获取核心人事信息 corehr:corehr 更新核心人事信息
字段权限要求> Tip: 该接口返回体中存在下列敏感字段，仅当开启对应的权限后才会返回；如果无需获取这些字段，则不建议申请 corehr:employment.position:read 获取员工的岗位信息 corehr:employment.position:write 读写员工的岗位信息 contact:user.employee_id:readonly 获取用户 user ID corehr:job_data.compensation_type:read 获取薪资类型 corehr:job_data.job_data_reason:read 读取任职原因 corehr:job_data.service_company:read 获取任职公司 corehr:job_data.work_shift:read 获取排班信息

请求头 ​

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

路径参数 ​

名称类型描述
job_data_idstring任职信息 ID，可通过【创建任职信息】、【批量查询员工任职信息】等接口获取
示例值："151515"

查询参数 ​

名称类型必填描述
user_id_typestring否用户 ID 类型
示例值：people_corehr_id
可选值有：
- open_id: 标识一个用户在某个应用中的身份。同一个用户在不同应用中的 Open ID 不同。了解更多：如何获取 Open ID - union_id: 标识一个用户在某个应用开发商下的身份。同一用户在同一开发商下的应用中的 Union ID 是相同的，在不同开发商下的应用中的 Union ID 是不同的。通过 Union ID，应用开发商可以把同个用户在多个应用中的身份关联起来。了解更多：如何获取 Union ID？ - user_id: 标识一个用户在某个租户内的身份。同一个用户在租户 A 和租户 B 内的 User ID 是不同的。在同一个租户内，一个用户的 User ID 在所有应用（包括商店应用）中都保持一致。User ID 主要用于在不同的应用间打通用户数据。了解更多：如何获取 User ID？ - people_corehr_id: 以飞书人事的 ID 来识别用户
默认值：people_corehr_id
当值为 user_id，字段权限要求： contact:user.employee_id:readonly 获取用户 user ID
department_id_typestring否此次调用中使用的部门 ID 类型
示例值：open_department_id
可选值有：
- open_department_id: 以 open_department_id 来标识部门 - department_id: 以 department_id 来标识部门 - people_corehr_department_id: 以 people_corehr_department_id 来标识部门
默认值：people_corehr_department_id

响应 ​

响应体 ​

名称类型描述
codeint错误码，非 0 表示失败
msgstring错误描述
data\--
  └ job_datajob_data任职信息
    └ idstring任职信息 ID
    └ version_idstring任职记录版本 ID
    └ job_level_idstring职务级别 ID，枚举值及详细信息可通过【查询单个职级】接口查询获得
    └ job_grade_idstring职等 ID，枚举值及详细信息可通过【查询职等】接口查询获得
    └ employee_type_idstring人员类型 ID，枚举值及详细信息可通过【查询单个人员类型】接口查询获得
    └ working_hours_type_idstring工时制度 ID，枚举值及详细信息可通过【查询单个工时制度】接口查询获得
    └ work_location_idstring工作地点 ID，枚举值及详细信息可通过【查询单个地点】接口查询获得
    └ department_idstring部门 ID，可通过【批量查询部门】接口查询详细信息 - 与 department_id_type 类型一致
    └ job_idstring职务 ID，枚举值及详细信息可通过【查询单个职务】接口查询获得
    └ probation_start_datestring试用期开始日期
    └ probation_end_datestring试用期结束日期（实际结束日期）
    └ primary_job_databoolean是否为主任职 - true：主职 - false：兼职，建议使用兼职相关接口
    └ employment_idstring雇佣 ID，可通过【批量查询员工信息】获取详细信息 与 user_id_type 类型一致
    └ effective_timestring任职记录版本的生效时间
    └ expiration_timestring任职记录版本的失效时间
    └ job_family_idstring职务序列 ID，枚举值及详细信息可通过【查询单个序列】接口查询获得
    └ assignment_start_reasonenum业务类型（原：任职原因） - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name：job_data - custom_api_name：assignment_start_reason
      └ enum_namestring枚举值
      └ displayi18n\[\]枚举多语展示
        └ langstring名称信息的语言
        └ valuestring名称信息的内容
    └ probation_expected_end_datestring预计试用期结束日期
    └ weekly_working_hoursint周工作时长
    └ direct_manager_idstring实线主管的任职记录ID，可通过【批量查询员工任职信息】获取
    └ dotted_line_manager_id_liststring\[\]虚线主管的任职记录ID，可通过【批量查询员工任职信息】获取
    └ second_direct_manager_idstring第二实线主管的任职记录ID，可通过【批量查询员工任职信息】获取
    └ cost_center_ratesupport_cost_center_item\[\]成本中心分摊信息
      └ cost_center_idstring支持的成本中心 ID，详细信息可通过【搜索成本中心信息】接口查询获得
      └ rateint分摊比例
    └ weekly_working_hours_v2number(float)周工作时长v2
    └ work_shiftenum排班类型，可通过【获取字段详情】接口查询，查询参数如下： - object_api_name = "job_data" - custom_api_name = "work_shift"
字段权限要求： corehr:job_data.work_shift:read 获取排班信息
      └ enum_namestring枚举值
      └ displayi18n\[\]枚举多语展示
        └ langstring语言
        └ valuestring内容
    └ compensation_typeenum薪资类型，可通过【获取字段详情】接口查询，查询参数如下： - object_api_name = "job_data" - custom_api_name = "compensation_type"
字段权限要求： corehr:job_data.compensation_type:read 获取薪资类型
      └ enum_namestring枚举值
      └ displayi18n\[\]枚举多语展示
        └ langstring语言
        └ valuestring内容
    └ service_companystring任职公司，枚举值及详细信息可通过【查询单个公司】接口查询获得
字段权限要求： corehr:job_data.service_company:read 获取任职公司
    └ employee_subtype_idstring人员子类型 ID - 功能灰度中，如有需求请联系技术支持
    └ position_idstring岗位 ID - 功能灰度中，如有需求请联系技术支持
字段权限要求（满足任一）： corehr:employment.position:read 获取员工的岗位信息 corehr:employment.position:write 读写员工的岗位信息
    └ job_data_reasonenum任职原因 - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name = "job_data" - custom_api_name = "job_data_reason"
字段权限要求： corehr:job_data.job_data_reason:read 读取任职原因
      └ enum_namestring枚举值
      └ displayi18n\[\]枚举多语展示
        └ langstring语言
        └ valuestring内容

响应体示例 ​

json
{
    "code": 0,
    "msg": "success",
    "data": {
        "job_data": {
            "id": "6890452208593372679",
            "version_id": "6890452208593372697",
            "job_level_id": "6890452208593372679",
            "job_grade_id": "6890452208593372679",
            "employee_type_id": "6890452208593372679",
            "working_hours_type_id": "6890452208593372679",
            "work_location_id": "6890452208593372679",
            "department_id": "6890452208593372679",
            "job_id": "6890452208593372679",
            "probation_start_date": "2018-03-16",
            "probation_end_date": "2019-05-24",
            "primary_job_data": true,
            "employment_id": "6893014062142064135",
            "effective_time": "2020-05-01 00:00:00",
            "expiration_time": "2020-05-02 00:00:00",
            "job_family_id": "1245678",
            "assignment_start_reason": {
                "enum_name": "type_1",
                "display": [
                    {
                        "lang": "zh-CN",
                        "value": "张三"
                    }
                ]
            },
            "probation_expected_end_date": "2006-01-02",
            "weekly_working_hours": 30,
            "direct_manager_id": "6890452208593372679",
            "dotted_line_manager_id_list": [
                "6890452208593372681"
            ],
            "second_direct_manager_id": "6890452208593372679",
            "cost_center_rate": [
                {
                    "cost_center_id": "6950635856373745165",
                    "rate": 100
                }
            ],
            "weekly_working_hours_v2": 37.5,
            "work_shift": {
                "enum_name": "example",
                "display": [
                    {
                        "lang": "zh-CN",
                        "value": "example"
                    }
                ]
            },
            "compensation_type": {
                "enum_name": "example",
                "display": [
                    {
                        "lang": "zh-CN",
                        "value": "example"
                    }
                ]
            },
            "service_company": "6890452208593372680",
            "employee_subtype_id": "6890452208593372680",
            "position_id": "6890452208593372679",
            "job_data_reason": {
                "enum_name": "example_option",
                "display": [
                    {
                        "lang": "zh-CN",
                        "value": "晋升"
                    }
                ]
            }
        }
    }
}

错误码 ​

HTTP状态码错误码描述排查建议
4001160004request ID repeatrequest ID 重复，请检查传入参数
4001160019The sum of cost center apportionment ratio should be 100.成本中心分摊比率之和应为100
4001160003record is deleted by others记录被其他人删除
5001160999unknown error请联系技术支持
5001160997unknown meta rpc error请联系技术支持
5001160998unknown vault rpc error请联系技术支持

内容来源：飞书开放平台 · 自动爬取整理

本镜像仅供学习与查阅，文档版权归飞书所有