飞书开放平台 Server API 文档

主题

新建职位 ​

创建一个新的职位。

注意事项 ​

  • 调用此接口前，需先打开「飞书招聘」-「设置」-「职位管理」-「职位设置」-「通过API同步职位开关」开关。

  • 字段是否必填，将以「飞书招聘」-「设置」-「职位管理」-「职位字段管理」中的设置为准。

请求 ​

项目值
HTTP URLhttps://open.feishu.cn/open-apis/hire/v1/jobs/combined_create
HTTP MethodPOST
接口频率限制20 次/秒
支持的应用类型custom
权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用hire:job 更新职位信息
字段权限要求> Tip: 该接口返回体中存在下列敏感字段，仅当开启对应的权限后才会返回；如果无需获取这些字段，则不建议申请 contact:user.employee_id:readonly 获取用户 user ID

请求头 ​

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

查询参数 ​

名称类型必填描述
user_id_typestring否用户 ID 类型
示例值：open_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？
默认值：open_id
当值为 user_id，字段权限要求： contact:user.employee_id:readonly 获取用户 user ID
department_id_typestring否指定查询结果中的部门 ID 类型。关于部门 ID 的详细介绍，可参见部门资源介绍。
示例值：open_department_id
可选值有：
- open_department_id: 由系统自动生成的部门 ID， ID前缀固定为 od-，在租户内全局唯一。 - department_id: 支持用户自定义配置的部门 ID。自定义配置时可复用已删除的 department_id，因此在未删除的部门范围内，department_id 具有唯一性。
默认值：open_department_id
job_level_id_typestring否此次调用中使用的「职级 ID」的类型
示例值：people_admin_job_level_id
可选值有：
- people_admin_job_level_id: 「人力系统管理后台」适用的职级 ID。人力系统管理后台逐步下线中，建议不继续使用此 ID。 - job_level_id: 「飞书管理后台」适用的职级 ID，通过获取租户职级列表接口获取
默认值：people_admin_job_level_id
job_family_id_typestring否此次调用中使用的「序列 ID」的类型
示例值：job_family_id
可选值有：
- people_admin_job_category_id: 「人力系统管理后台」适用的序列 ID。人力系统管理后台逐步下线中，建议不继续使用此 ID。 - job_family_id: 「飞书管理后台」适用的序列 ID，通过获取租户序列列表接口获取
默认值：people_admin_job_category_id

请求体 ​

名称类型必填描述
codestring否职位编码，传入需保证唯一性，不传系统会自动生成一个唯一编码，限定长度16字节
示例值："R18"
experienceint否工作经验要求
示例值：1
可选值有：
- 1: 不限 - 2: 应届毕业生 - 3: 1年以下 - 4: 1-3年 - 5: 3-5年 - 6: 5-7年 - 7: 7-10年 - 8: 10年以上
expiry_timeint否到期日期，此字段已废弃，请使用expiry_timestamp
示例值：1622484739
customized_data_listcombined_job_object_value_map\[\]否自定义字段
  └ object_idstring否自定义字段 ID，可通过获取职位模板接口获取
示例值："7281257045172308287"
  └ valuestring否自定义字段值，请参考本文「自定义字段数据格式说明」。
示例值："职位特殊要求"
min_level_idstring否最低职级 ID，需与入参job_level_id_type 类型一致
示例值："7281257045172308287"
min_salaryint否最低月薪，单位：K
示例值：1000
titlestring是职位名称
示例值："后端研发"
job_managersjob.manager是职位管理者
  └ idstring否职位 ID（此字段无需填充，请忽略）
示例值："7281257045172308287"
  └ recruiter_idstring是招聘负责人 ID，需与入参user_id_type类型一致
示例值："ou_efk39117c300506837def50545420c6a"
  └ hiring_manager_id_liststring\[\]是用人经理 ID 列表，需与入参user_id_type类型一致
示例值：["on_94a1ee5551019f18cd73d9f111898cf2"]
  └ assistant_id_liststring\[\]否协助人 ID 列表，需与入参user_id_type类型一致
示例值：["on_94a1ee5551019f18cd73d9f111898cf2"]
job_process_idstring是招聘流程 ID，可通过获取招聘流程信息接口获取
示例值："6960663240925956554"
process_typeint是职位流程类型
示例值：1
可选值有：
- 1: 社招 - 2: 校招
subject_idstring否项目 ID，可通过获取项目列表接口获取
示例值："6960663240925956555"
job_function_idstring否职能分类ID，可通过获取职能分类列表接口获取
示例值："6960663240925956555"
department_idstring是部门 ID，需与入参中的department_id_type类型一致
示例值："od-b2fafdce6fc5800b574ba5b0e2798b36"
head_countint否招聘数量
示例值：100
is_never_expiredboolean是是否长期有效
示例值：false
max_salaryint否最高月薪，单位：K
示例值：2000
requirementstring否职位要求
示例值："熟悉后端研发"
descriptionstring否职位描述
示例值："后端研发岗位描述"
highlight_liststring\[\]否职位亮点列表，可通过枚举常量介绍中职位亮枚举定义」获取
示例值：["6732430418202593547"]
job_type_idstring是职位类别 ID，可通过获取职位类别列表接口获取
示例值："6960663240925956551"
max_level_idstring否最高职级 ID，需与入参job_level_id_type 类型一致
示例值："6960663240925956548"
recruitment_type_idstring是雇佣类型 ID，详情请参考：枚举常量介绍中「职位性质/雇佣类型（recruitment_type）枚举定义」
示例值："102"
required_degreeint否学历要求
示例值：20
可选值有：
- 1: 小学及以上 - 2: 初中及以上 - 3: 专职及以上 - 4: 高中及以上 - 5: 大专及以上 - 6: 本科及以上 - 7: 硕士及以上 - 8: 博士及以上 - 20: 不限
job_category_idstring否序列 ID，需与入参job_family_id_type 类型一致
示例值："6960663240925956550"
address_id_liststring\[\]否工作地址列表，可通过获取地址列表接口获取
示例值：["7243965681799839748"]
job_attributeint否职位属性
示例值：1
可选值有：
- 1: 实体职位 - 2: 虚拟职位
expiry_timestampstring否到期时间，毫秒时间戳，如果is_never_expired字段选择true，则不会实际使用该字段的值，职位为长期有效
示例值："1622484739955"
interview_registration_schema_idstring否面试登记表 ID，当在飞书招聘「设置 - 候选人信息管理 - 申请表和登记表使用设置 - 面试登记表使用方式」中选择「HR 按职位选择登记表」时，该字段为必填；否则该字段不生效。可通过获取面试登记表模板列表接口获取。
示例值："6930815272790114324"
onboard_registration_schema_idstring否入职登记表 ID，当在飞书招聘「设置 - 候选人信息管理 - 申请表和登记表使用设置 - 入职登记表使用方式」中选择「HR 按职位选择登记表」时，该字段为必填；否则该字段不生效。可通过获取信息登记表模板列表接口获取。
示例值："6930815272790114325"
target_major_id_liststring\[\]否目标专业 ID 列表
示例值：["MDMJ00000067"]
portal_website_apply_form_schema_idstring否官网申请表ID，可通过获取招聘官网申请表模板列表 接口获取
示例值："7397638158859323692"

自定义字段数据格式说明 ​

  • 单选："1"
  • 多选："[\"1\", \"2\"]"
  • 单行："单行文本"
  • 多行："多行文本"
  • 数字："1"
  • 月份选择："1627379423000"
  • 年份选择："1627379423000"
  • 日期选择："1627379423000"
  • 附件："[{\"file_id\": \"7250161881116838204\"},{\"file_id\": \"7250161808660826429\"}]"
  • 时间段："[\"1577808000000\", \"1612108800000\"]"

请求体示例 ​

json
{
    "code": "R18",
    "experience": 1,
    "expiry_time": 1622484739,
    "customized_data_list": [
        {
            "object_id": "7281257045172308287",
            "value": "职位特殊要求"
        }
    ],
    "min_level_id": "7281257045172308287",
    "min_salary": 1000,
    "title": "后端研发",
    "job_managers": {
        "id": "7281257045172308287",
        "recruiter_id": "ou_efk39117c300506837def50545420c6a",
        "hiring_manager_id_list": [
            "on_94a1ee5551019f18cd73d9f111898cf2"
        ],
        "assistant_id_list": [
            "on_94a1ee5551019f18cd73d9f111898cf2"
        ]
    },
    "job_process_id": "6960663240925956554",
    "process_type": 1,
    "subject_id": "6960663240925956555",
    "job_function_id": "6960663240925956555",
    "department_id": "od-b2fafdce6fc5800b574ba5b0e2798b36",
    "head_count": 100,
    "is_never_expired": false,
    "max_salary": 2000,
    "requirement": "熟悉后端研发",
    "description": "后端研发岗位描述",
    "highlight_list": [
        "6732430418202593547"
    ],
    "job_type_id": "6960663240925956551",
    "max_level_id": "6960663240925956548",
    "recruitment_type_id": "102",
    "required_degree": 20,
    "job_category_id": "6960663240925956550",
    "address_id_list": [
        "7243965681799839748"
    ],
    "job_attribute": 1,
    "expiry_timestamp": "1622484739955",
    "interview_registration_schema_id": "6930815272790114324",
    "onboard_registration_schema_id": "6930815272790114325",
    "target_major_id_list": [
        "MDMJ00000067"
    ],
    "portal_website_apply_form_schema_id": "7397638158859323692"
}

响应 ​

响应体 ​

名称类型描述
codeint错误码，非 0 表示失败
msgstring错误描述
datacombined_job_result-
  └ default_job_postcombined_job_result_default_job_post职位广告
    └ idstring默认职位广告的 ID，可通过职位发布至官网接口 发布至官网
  └ jobjob职位
    └ idstring职位 ID，详情请查看：获取职位信息
    └ titlestring职位名称
    └ descriptionstring职位描述
    └ codestring职位编号
    └ requirementstring职位要求
    └ recruitment_typejob_recruitment_type雇佣类型
      └ idstring雇佣类型 ID，详情请参考：枚举常量介绍中「职位性质/雇佣类型（recruitment_type）枚举定义」
      └ zh_namestring雇佣类型中文名称
      └ en_namestring雇佣类型英文名称
      └ active_statusint雇佣类型启用状态
可选值有：
- 1: 启用 - 2: 未启用
    └ departmentjob_department部门
      └ idstring部门 ID，与入参中的department_id_type类型一致
      └ zh_namestring部门中文名称
      └ en_namestring部门英文名称
    └ cityjob_city工作城市
      └ city_codestring工作城市码，详情请查看：查询地点列表
      └ zh_namestring工作城市中文名称
      └ en_namestring工作城市英文名称
    └ min_job_leveljob_level最低职级
      └ idstring职级 ID，与入参job_level_id_type 类型一致
      └ zh_namestring职级中文名称
      └ en_namestring职级英文名称
      └ active_statusint职级启用状态
可选值有：
- 1: 启用 - 2: 未启用
    └ max_job_leveljob_level最高职级
      └ idstring职级 ID，与入参job_level_id_type 类型一致
      └ zh_namestring职级中文名称
      └ en_namestring职级英文名称
      └ active_statusint职级启用状态
可选值有：
- 1: 启用 - 2: 未启用
    └ highlight_listjob_highlight\[\]职位亮点
      └ idstring职位亮点列表，详情请查看：枚举常量介绍中职位亮枚举定义」
      └ zh_namestring职位亮点中文名称
      └ en_namestring职位亮点英文名称
    └ job_categoryjob_category职位序列
      └ idstring职位序列 ID，与入参job_family_id_type 类型一致
      └ zh_namestring职位序列中文名称
      └ en_namestring职位序列英文名称
      └ active_statusint职位序列启用状态
可选值有：
- 1: 启用 - 2: 未启用
    └ job_typejob_type职位类别
      └ idstring职位类别 ID，详情请查看：获取职位类别列表
      └ zh_namestring职位类别中文名称
      └ en_namestring职位类别英文名称
    └ active_statusint启用状态
可选值有：
- 1: 启用 - 2: 未启用
    └ create_user_idstring创建人ID，若为空则为系统创建，与入参user_id_type类型一致
    └ create_timeint创建时间，此字段已废弃，请使用create_timestamp
    └ update_timeint更新时间，此字段已废弃，请使用update_timestamp
    └ process_typeint招聘流程类型
可选值有：
- 1: 社招流程 - 2: 校招流程
    └ process_idstring招聘流程 ID，详情请查看：获取招聘流程信息
    └ process_namestring招聘流程中文名称
    └ process_en_namestring招聘流程英文名称
    └ customized_data_listjob_customized_data\[\]自定义字段列表
      └ object_idstring自定义字段 ID
      └ namei18n自定义字段名称
        └ zh_cnstring字段中文名称
        └ en_usstring字段英文名称
      └ object_typeint字段类型
可选值有：
- 1: 单行文本 - 2: 多行文本 - 3: 单选 - 4: 多选 - 5: 日期 - 6: 月份选择 - 7: 年份选择 - 8: 时间段 - 9: 数字 - 10: 默认字段 - 11: 模块
      └ valuejob_customized_value自定义字段值
        └ contentstring当字段类型为单行文本、多行文本、模块、默认字段时，从此字段取值
        └ optionjob_customized_option当字段类型为单选时，从此字段取值
          └ keystring选项 ID
          └ namei18n选项名称
            └ zh_cnstring选项中文名称
            └ en_usstring选项英文名称
        └ option_listjob_customized_option\[\]当字段类型为多选时，从此字段取值
          └ keystring选项 ID
          └ namei18n选项名称
            └ zh_cnstring选项中文名称
            └ en_usstring选项英文名称
        └ time_rangejob_customized_time_range当字段类型为时间段时，从此字段取值
          └ start_timestring开始时间，毫秒时间戳
          └ end_timestring结束时间，毫秒时间戳
        └ timestring当字段类型为日期选择、月份选择、年份选择时，从此字段取值，该字段是毫秒级时间戳
        └ numberstring当字段类型为数字时，从此字段取值
    └ job_functionid_name_object职能分类
      └ idstring职能 ID，详情请查看：获取职能分类列表
      └ namei18n职能名称
        └ zh_cnstring职能中文名称
        └ en_usstring职能英文名称
    └ subjectid_name_object项目
      └ idstring项目 ID，详情请查看：获取项目列表
      └ namei18n项目名称
        └ zh_cnstring项目中文名称
        └ en_usstring项目英文名称
    └ head_countint招聘数量
    └ experienceint工作经验要求
可选值有：
- 1: 不限 - 2: 应届毕业生 - 3: 1年以下 - 4: 1-3年 - 5: 3-5年 - 6: 5-7年 - 7: 7-10年 - 8: 10年以上
    └ expiry_timeint到期日期，此字段已废弃，请使用expiry_timestamp
    └ min_salaryint最低月薪，单位：K
    └ max_salaryint最高月薪，单位：K
    └ required_degreeint学历要求
可选值有：
- 1: 小学及以上 - 2: 初中及以上 - 3: 专职及以上 - 4: 高中及以上 - 5: 大专及以上 - 6: 本科及以上 - 7: 硕士及以上 - 8: 博士及以上 - 20: 不限
    └ city_listcode_name_object\[\]工作城市列表
      └ codestring城市编码，详情请查看：查询地点列表
      └ namei18n城市名称
        └ zh_cnstring地点中文名称
        └ en_usstring城市英文名称
    └ job_attributeint职位属性
可选值有：
- 1: 实体职位 - 2: 虚拟职位
    └ create_timestampstring创建时间，毫秒时间戳
    └ update_timestampstring更新时间，毫秒时间戳
    └ expiry_timestampstring到期时间，毫秒时间戳，如果is_never_expired字段选择true，则不会实际使用该字段的值，职位为长期有效
    └ target_major_listtarget_major_info\[\]目标专业列表
      └ idstring目标专业 ID，详情请查看：「根据主数据编码批量获取专业」
      └ zh_namestring目标专业中文名称
      └ en_namestring目标专业英文名称
  └ job_managerjob.manager职位负责人
    └ idstring职位 ID，详情请查看：获取职位信息
    └ recruiter_idstring招聘负责人 ID，与入参user_id_type类型一致
    └ hiring_manager_id_liststring\[\]用人经理 ID 列表，与入参user_id_type类型一致
    └ assistant_id_liststring\[\]协助人 ID 列表，与入参user_id_type类型一致
  └ interview_registration_schema_inforegistration_schema_info面试登记表信息
    └ schema_idstring面试登记表 ID，详情可查看：获取面试登记表模板列表
    └ namestring面试登记表名称
  └ onboard_registration_schema_inforegistration_schema_info入职登记表信息
    └ schema_idstring入职登记表 ID，详情请查看：获取信息登记表模板列表
    └ namestring入职登记表名称
  └ target_major_listtarget_major_info\[\]目标专业
    └ idstring目标专业ID，「0」 为不限专业
    └ zh_namestring目标专业中文名称
    └ en_namestring目标专业英文名称
  └ portal_website_apply_form_schema_inforegistration_schema_info官网申请表
    └ schema_idstring官网申请表ID
    └ namestring官网申请表名称

响应体示例 ​

json
{
    "code": 0,
    "msg": "ok",
    "data": {
        "default_job_post": {
            "id": "6960663240925956568"
        },
        "job": {
            "id": "7281257045172308287",
            "title": "测试职位",
            "description": "这是一个测试职位",
            "code": "Z188",
            "requirement": "要求高学历人才",
            "recruitment_type": {
                "id": "7281257045172308287",
                "zh_name": "全职",
                "en_name": "FullTime",
                "active_status": 1
            },
            "department": {
                "id": "7281257045172308287",
                "zh_name": "字节跳动",
                "en_name": "Bytedance"
            },
            "city": {
                "city_code": "CT_20",
                "zh_name": "成都",
                "en_name": "Chengdu"
            },
            "min_job_level": {
                "id": "7281257045172308287",
                "zh_name": "级别-2",
                "en_name": "level-2",
                "active_status": 1
            },
            "max_job_level": {
                "id": "7281257045172308287",
                "zh_name": "级别-2",
                "en_name": "level-2",
                "active_status": 1
            },
            "highlight_list": [
                {
                    "id": "7281257045172308287",
                    "zh_name": "团队氛围好",
                    "en_name": "Positive team atmosphere"
                }
            ],
            "job_category": {
                "id": "7281257045172308287",
                "zh_name": "序列-A",
                "en_name": "category-A",
                "active_status": 1
            },
            "job_type": {
                "id": "6890840777044265230",
                "zh_name": "金融",
                "en_name": "Finance"
            },
            "active_status": 1,
            "create_user_id": "7281257045172308287",
            "create_time": 1617170925462,
            "update_time": 1617170925462,
            "process_type": 1,
            "process_id": "1",
            "process_name": "流程中文名",
            "process_en_name": "流程英文名",
            "customized_data_list": [
                {
                    "object_id": "7281257045172308287",
                    "name": {
                        "zh_cn": "职位特殊要求",
                        "en_us": "field 1"
                    },
                    "object_type": 1,
                    "value": {
                        "content": "这是一个单行文本",
                        "option": {
                            "key": "7281257045172308287",
                            "name": {
                                "zh_cn": "选项 A",
                                "en_us": "Option A"
                            }
                        },
                        "option_list": [
                            {
                                "key": "7281257045172308287",
                                "name": {
                                    "zh_cn": "选项 A",
                                    "en_us": "Option A"
                                }
                            }
                        ],
                        "time_range": {
                            "start_time": "1622484739955",
                            "end_time": "1622484739955"
                        },
                        "time": "1625456721000",
                        "number": "111"
                    }
                }
            ],
            "job_function": {
                "id": "7281257045172308287",
                "name": {
                    "zh_cn": "测试职能",
                    "en_us": "test job function"
                }
            },
            "subject": {
                "id": "7281257045172308287",
                "name": {
                    "zh_cn": "测试项目",
                    "en_us": "test subject"
                }
            },
            "head_count": 100,
            "experience": 1,
            "expiry_time": 1622484739955,
            "min_salary": 10,
            "max_salary": 20,
            "required_degree": 1,
            "city_list": [
                {
                    "code": "CT_223",
                    "name": {
                        "zh_cn": "成都",
                        "en_us": "Chengdu"
                    }
                }
            ],
            "job_attribute": 1,
            "create_timestamp": "1617170925462",
            "update_timestamp": "1617170925462",
            "expiry_timestamp": "1622484739955",
            "target_major_list": [
                {
                    "id": "MDMJ00000067",
                    "zh_name": "考古",
                    "en_name": "archeology"
                }
            ]
        },
        "job_manager": {
            "id": "1618209327096",
            "recruiter_id": "ou_efk39117c300506837def50545420c6a",
            "hiring_manager_id_list": [
                "on_94a1ee5551019f18cd73d9f111898cf2"
            ],
            "assistant_id_list": [
                "on_94a1ee5551019f18cd73d9f111898cf2"
            ]
        },
        "interview_registration_schema_info": {
            "schema_id": "6930815272790114324",
            "name": "默认登记表"
        },
        "onboard_registration_schema_info": {
            "schema_id": "6930815272790114324",
            "name": "默认登记表"
        },
        "target_major_list": [
            {
                "id": "6930815272790114324",
                "zh_name": "考古",
                "en_name": "archeology"
            }
        ],
        "portal_website_apply_form_schema_info": {
            "schema_id": "6930815272790114324",
            "name": "默认申请表"
        }
    }
}

错误码 ​

HTTP状态码错误码描述排查建议
5001002001System error请根据实际报错信息定位或咨询技术支持。
4001002002Parameter illegal检查参数是否正确，例如类型，大小
4001002613The synchronization switch has not been turned on. You can only create, edit or close jobs in the recruitment system请确认职位同步开关是否已开启；路径：「飞书招聘」-「设置」-「职位管理」-「职位设置」-「通过API同步职位开关」
4001002603Position type does not exist职位类别不存在，请检查job_type_id 参数是否正确
4001002604Recruitment type does not exist雇佣类型不存在，请检查recruitment_type 参数是否正确
4001002605Sequence does not exist序列不存在，请检查job_category_id 参数是否正确
4001002606Level does not exist级别不存在，请检查max_level_id 或min_level_id 参数是否正确
4001002607Position highlight does not exist职位亮点不存在，请检查highlight_list 参数是否正确
4001002608Subject does not exist项目不存在，请检查subject_id 参数是否正确
4001002609Job Closed职位已关闭，请通过获取职位信息接口查看职位关闭状态
4001002622Target major doesn't exist. Please confirm whether the major ID is correct.目标专业不存在，请检查target_major_id_list 参数是否正确
4001002623Unable to set other target majors if "Major unlimited" is selected选择「不限专业」时不可设置其他目标专业，请检查target_major_id_list 参数是否还额外设置其他目标专业
4001002630Job Level is disable职位职级已停用，请检查max_level_id 或min_level_id 参数是否正确

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

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