飞书开放平台 Server API 文档

主题

更新职位设置 ​

更新职位设置，包括面试评价表、Offer 申请表等。

注意事项 ​

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

请求 ​

项目值
HTTP URLhttps://open.feishu.cn/open-apis/hire/v1/jobs/:job_id/update_config
HTTP MethodPOST
接口频率限制10 次/秒
支持的应用类型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"

路径参数 ​

名称类型描述
job_idstring职位 ID，可通过获取职位列表接口获取
示例值："6960663240925956660"

查询参数 ​

名称类型必填描述
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

请求体 ​

名称类型必填描述
offer_apply_schema_idstring否Offer 申请表 ID，可通过获取 Offer 申请表列表接口获取，当update_option_list包含更新 Offer 申请表时，该参数必填
示例值："6960663240925956573"
offer_process_confstring否Offer 审批流程 ID，可通过获取 Offer 审批流配置列表接口获取
示例值："6960663240925956572"
recommended_evaluator_id_liststring\[\]否建议评估人 ID 列表，需与入参user_id_type类型一致
示例值：["6966533137982392320"]
update_option_listint\[\]是更新选项，传入要更新的配置项 - 接口将按照所选择的「选项」进行设置参数校验和更新。若设置的必填字段更新时未填写内容，接口将报错无法完成更新。
示例值：[6]
可选值有：
- 1: 更新面试评价表 - 2: 更新 Offer 申请表 - 3: 更新 Offer 审批流程 - 4: 更新招聘需求 - 5: 更新建议面试官 - 6: 更新建议评估人 - 8: 更新关联职位 - 9: 更新面试官安排面试配置 - 10: 更新面试登记表 - 11: 更新入职登记表 - 12: 更新官网申请表
assessment_template_biz_idstring否面试评价表 ID，可通过获取面试评价表列表接口获取，当同时满足以下两个条件时，该参数必填： - update_option_list包含更新面试评价表 - 「飞书招聘」-「设置」-「面试轮次类型设置」-「启用面试轮次类型」开关关闭
示例值："6960663240925956571"
interview_round_conf_listjob_config_interview_round_conf\[\]否建议面试官列表，当update_option_list包含更新建议面试官时，该参数必填
  └ interviewer_id_liststring\[\]否建议面试官 ID 列表，需与入参user_id_type类型一致
示例值：["6960663240925956571"]
  └ roundint否面试轮次
示例值：1
jr_id_liststring\[\]否关联招聘需求，可通过获取招聘需求信息接口获取
示例值：["6966533137982392320"]
interview_registration_schema_idstring否面试登记表 ID，可通过获取面试登记表模板列表接口获取。 注意： - 当在「飞书招聘」-「设置」 -「信息登记表使用设置」 - 「申请表和登记表使用设置」中选择「HR 按职位选择登记表」时，该字段为必填；否则该字段不生效 - 当update_option_list包含更新面试登记表时，该参数必填
示例值："6930815272790114324"
onboard_registration_schema_idstring否入职登记表 ID，可通过获取信息登记表模板列表接口获取。 注意： - 当在飞书招聘「设置」 - 「信息登记表使用设置」 - 「入职登记表使用方式」中选择「HR 按职位选择登记表」时，该字段为必填；否则该字段不生效 - 当update_option_list包含更新入职登记表时，该参数必填
示例值："6930815272790114324"
interview_round_type_conf_listjob_config_round_type\[\]否面试轮次类型 ID 列表，当同时满足以下两个条件时，该参数必填： - update_option_list包含更新面试评价表 - 「飞书招聘」-「设置」-「面试轮次类型设置」-「启用面试轮次类型」开关打开
  └ round_biz_idstring否面试轮次类型 ID，可通过接口获取面试轮次类型列表获取。
示例值："7012129842917837100"
  └ assessment_template_biz_idstring否面试评价表 ID，可通过获取面试评价表列表接口获取
示例值："6960663240925956632"
related_job_id_liststring\[\]否关联职位列表，如职位为实体职位则关联虚拟职位 ID，如职位为虚拟职位则关联实体职位 ID，可通过获取职位列表接口获取
示例值：["6966533137982392320"]
interview_appointment_configinterview_appointment_config否自助约面配置，当update_option_list包含更新面试官安排面试配置时，该参数必填
  └ enable_interview_appointment_by_interviewerboolean否是否开启面试官自助约面
示例值：true
  └ configinterview_appointment_config_content否配置详情
    └ interview_typeint否面试类型
示例值：1
可选值有：
- 1: 现场面试 - 2: 电话面试 - 3: 视频面试
    └ talent_timezone_codestring否候选人时区
示例值："Asia/Shanghai"
    └ contact_user_idstring否面试联系人 ID，需与入参user_id_type类型一致
示例值："ou_c99c5f35d542efc7ee492afe11af19ef"
    └ contact_mobilestring否面试联系人电话
示例值："151********"
    └ contact_emailstring否面试联系人邮箱
示例值："test@email"
    └ address_idstring否面试地点 ID，可通过获取地址列表接口获取
示例值："6960663240925956576"
    └ video_typeint否视频面试类型
示例值：1
可选值有：
- 1: zoom - 2: 牛客技术类型 - 3: 牛客非技术类型 - 4: 赛码 - 5: 飞书 - 8: Hackerrank - 9: 飞书(含代码考核) - 100: 不使用系统工具
    └ ccstring\[\]否抄送人 ID 列表，需与入参user_id_type类型一致
示例值：["6930815272790114324"]
    └ remarkstring否面试配置备注
示例值："仅仅用于视频面试"
    └ interview_notification_template_idstring否面试通知模板 ID
示例值："6960663240925956573"
    └ appointment_notification_template_idstring否预约通知模板 ID
示例值："6960663240925956573"
    └ cancel_interview_notification_template_idstring否取消面试通知模版 ID
示例值："6960663240925956573"
portal_website_apply_form_schema_idstring否官网申请表ID，可通过获取招聘官网申请表模板列表 接口获取
示例值："6930815272790114324"

请求体示例 ​

json
{
    "offer_apply_schema_id": "6960663240925956573",
    "offer_process_conf": "6960663240925956572",
    "recommended_evaluator_id_list": [
        "6966533137982392320"
    ],
    "update_option_list": [
        6
    ],
    "assessment_template_biz_id": "6960663240925956571",
    "interview_round_conf_list": [
        {
            "interviewer_id_list": [
                "6960663240925956571"
            ],
            "round": 1
        }
    ],
    "jr_id_list": [
        "6966533137982392320"
    ],
    "interview_registration_schema_id": "6930815272790114324",
    "onboard_registration_schema_id": "6930815272790114324",
    "interview_round_type_conf_list": [
        {
            "round_biz_id": "7012129842917837100",
            "assessment_template_biz_id": "6960663240925956632"
        }
    ],
    "related_job_id_list": [
        "6966533137982392320"
    ],
    "interview_appointment_config": {
        "enable_interview_appointment_by_interviewer": true,
        "config": {
            "interview_type": 1,
            "talent_timezone_code": "Asia/Shanghai",
            "contact_user_id": "ou_c99c5f35d542efc7ee492afe11af19ef",
            "contact_mobile": "151********",
            "contact_email": "test@email",
            "address_id": "6960663240925956576",
            "video_type": 1,
            "cc": [
                "6930815272790114324"
            ],
            "remark": "仅仅用于视频面试",
            "interview_notification_template_id": "6960663240925956573",
            "appointment_notification_template_id": "6960663240925956573",
            "cancel_interview_notification_template_id": "6960663240925956573"
        }
    },
    "portal_website_apply_form_schema_id": "6930815272790114324"
}

响应 ​

响应体 ​

名称类型描述
codeint错误码，非 0 表示失败
msgstring错误描述
data\--
  └ job_configjob_config_result职位设置
    └ offer_apply_schemaid_name_objectOffer 申请表
      └ idstringOffer 申请表 ID，详情可查看：获取 Offer 申请表列表
      └ namei18nOffer 申请表名称
        └ zh_cnstringOffer 申请表中文名称
        └ en_usstringOffer 申请表英文名称
    └ offer_process_confid_name_objectOffer 审批流程
      └ idstringOffer 审批流程 ID，详情请查看：获取 Offer 审批流配置列表
      └ namei18nOffer 审批流程名称
        └ zh_cnstringOffer 审批流程中文名称
        └ en_usstringOffer 审批流程英文名称
    └ recommended_evaluator_listid_name_object\[\]建议评估人列表
      └ idstring评估人 ID，与入参user_id_type类型一致
      └ namei18n评估人名称
        └ zh_cnstring评估人中文名称
        └ en_usstring评估人英文名称
    └ assessment_templateid_name_object面试评价表
      └ idstring面试评价表 ID，详情请查看：获取面试评价表列表
      └ namei18n面试评价表名称
        └ zh_cnstring面试评价表中文名称
        └ en_usstring面试评价表英文名称
    └ idstring职位 ID，详情请查看：获取职位信息
    └ interview_round_listjob_config_interview_round\[\]建议面试官列表
      └ interviewer_listid_name_object\[\]面试官列表
        └ idstring面试官 ID，与入参user_id_type类型一致
        └ namei18n面试官名称
          └ zh_cnstring面试官中文名称
          └ en_usstring面试官英文名称
      └ roundint面试轮次
    └ job_requirement_listid_name_object\[\]招聘需求
      └ idstring招聘需求 ID，详情请查看：获取招聘需求信息
      └ namei18n招聘需求名称
        └ zh_cnstring招聘需求中文名称
        └ en_usstring招聘需求英文名称
    └ interview_registrationregistration_info面试登记表
      └ schema_idstring面试登记表 ID，详情可查看：获取面试登记表模板列表
      └ namestring面试登记表名称
    └ onboard_registrationregistration_info入职登记表
      └ schema_idstring入职登记表 ID
      └ namestring入职登记表名称
    └ interview_round_type_listjob_config_round_type_result\[\]面试轮次类型列表
      └ assessment_roundid_name_object面试轮次类型
        └ idstring面试轮次类型 ID，详情请查看：获取面试轮次类型列表
        └ namei18n面试轮次类型名称
          └ zh_cnstring面试轮次类型中文名称
          └ en_usstring面试轮次类型英文名称
      └ assessment_templateid_name_object面试评价表
        └ idstring面试评价表 ID，详情请查看：获取面试评价表列表
        └ namei18n面试评价表名称
          └ zh_cnstring面试评价表中文名称
          └ en_usstring面试评价表英文名称
    └ related_job_listid_name_object\[\]关联职位列表
      └ idstring关联职位 ID，详情请查看获取职位信息
      └ namei18n关联职位名称
        └ zh_cnstring关联职位中文名称
        └ en_usstring关联职位英文名称
    └ job_attributeint职位属性 可选值： - 1：实体职位 - 2：虚拟职位
    └ interview_appointment_configinterview_appointment_config面试官安排面试配置
      └ enable_interview_appointment_by_interviewerboolean是否开启面试官安排面试
      └ configinterview_appointment_config_content配置详情
        └ interview_typeint面试类型
可选值有：
- 1: 现场面试 - 2: 电话面试 - 3: 视频面试
        └ talent_timezone_codestring候选人时区
        └ contact_user_idstring面试联系人 ID，与入参user_id_type类型一致
        └ contact_mobilestring面试联系人电话
        └ contact_emailstring面试联系人邮箱
        └ address_idstring面试地点 ID，详情请查看：获取地址列表
        └ video_typeint视频面试类型
可选值有：
- 1: zoom - 2: 牛客技术类型 - 3: 牛客非技术类型 - 4: 赛码 - 5: 飞书 - 8: Hackerrank - 9: 飞书(含代码考核) - 100: 不使用系统工具
        └ ccstring\[\]抄送人 ID 列表，需与入参user_id_type类型一致
        └ remarkstring面试配置备注
        └ interview_notification_template_idstring面试通知模板 ID
        └ appointment_notification_template_idstring预约通知模板 ID
        └ cancel_interview_notification_template_idstring取消面试通知模版 ID
    └ portal_website_apply_form_schema_inforegistration_info官网申请表
      └ schema_idstring官网申请表ID，可通过获取招聘官网申请表模板列表 获取申请表详情
      └ namestring官网申请表名称

响应体示例 ​

json
{
    "code": 0,
    "msg": "ok",
    "data": {
        "job_config": {
            "offer_apply_schema": {
                "id": "7392444731470563625",
                "name": {
                    "zh_cn": "测试 Offer 申请表",
                    "en_us": "Test Offer 申请表"
                }
            },
            "offer_process_conf": {
                "id": "7392444731470563625",
                "name": {
                    "zh_cn": "审批流程1",
                    "en_us": "Test Process 1"
                }
            },
            "recommended_evaluator_list": [
                {
                    "id": "7392444731470563625",
                    "name": {
                        "zh_cn": "张三",
                        "en_us": "ZhangSan"
                    }
                }
            ],
            "assessment_template": {
                "id": "7392444731470563625",
                "name": {
                    "zh_cn": "评价表1",
                    "en_us": "assessment_template·1"
                }
            },
            "id": "6960663240925956574",
            "interview_round_list": [
                {
                    "interviewer_list": [
                        {
                            "id": "7392444731470563625",
                            "name": {
                                "zh_cn": "张三",
                                "en_us": "ZhangSan"
                            }
                        }
                    ],
                    "round": 1
                }
            ],
            "job_requirement_list": [
                {
                    "id": "6930815272790114324",
                    "name": {
                        "zh_cn": "校招需求",
                        "en_us": "campus jr"
                    }
                }
            ],
            "interview_registration": {
                "schema_id": "6930815272790114324",
                "name": "默认登记表"
            },
            "onboard_registration": {
                "schema_id": "6930815272790114324",
                "name": "默认登记表"
            },
            "interview_round_type_list": [
                {
                    "assessment_round": {
                        "id": "7392444731470563625",
                        "name": {
                            "zh_cn": "测试类型",
                            "en_us": "Test type"
                        }
                    },
                    "assessment_template": {
                        "id": "7392444731470563625",
                        "name": {
                            "zh_cn": "评价表1",
                            "en_us": "assessment_template·1"
                        }
                    }
                }
            ],
            "related_job_list": [
                {
                    "id": "6930815272790114324",
                    "name": {
                        "zh_cn": "测试职位",
                        "en_us": "test job"
                    }
                }
            ],
            "job_attribute": 1,
            "interview_appointment_config": {
                "enable_interview_appointment_by_interviewer": true,
                "config": {
                    "interview_type": 1,
                    "talent_timezone_code": "Asia/Shanghai",
                    "contact_user_id": "ou_c99c5f35d542efc7ee492afe11af19ef",
                    "contact_mobile": "177xxxx1773",
                    "contact_email": "test@open.com",
                    "address_id": "6960663240925956576",
                    "video_type": 1,
                    "cc": [
                        "ou_c99c5f35d542efc7ee492afe11af19ef"
                    ],
                    "remark": "这个职位最好选择现场牛客网面试",
                    "interview_notification_template_id": "6960663240925956573",
                    "appointment_notification_template_id": "6960663240925956573",
                    "cancel_interview_notification_template_id": "6960663240925956573"
                }
            },
            "portal_website_apply_form_schema_info": {
                "schema_id": "6930815272790114324",
                "name": "默认申请表"
            }
        }
    }
}

错误码 ​

HTTP状态码错误码描述排查建议
5001002001系统错误请根据实际报错信息定位或咨询技术支持
4001002002参数错误检查参数是否正确，例如类型，大小
4001002613「通过 API 同步职位」开关尚未打开，仅支持在招聘系统中新建、编辑或关闭职位请确认「通过 API 同步职位」开关是否已开启；路径：「招聘系统」-「设置」-「职位管理」-「职位设置」-「通过 API 同步职位」
4001002609职位已关闭职位已关闭，请通过获取职位信息接口查看职位关闭状态
4001002611Offer 审批流程不适用于当前部门可通过获取 Offer 审批流配置列表接口查看当前流程的适用部门是否包含当前 Offer 对应部门
4001002620不可关联同属性职位不可关联同属性职位，如虚拟职位不能关联虚拟职位，请检查related_job_id_list 参数是否正确
4001002621实体职位只可关联一个虚拟职位实体职位只可关联一个虚拟职位，请检查related_job_id_list 参数是否正确
4001002703招聘需求不存在招聘需求不存在，请检查jr_id_list 参数是否正确

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

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