# 新建招聘官网投递 新建招聘官网投递。 ## 注意事项 - 请求参数中邮箱/电话等字段请在「飞书招聘」-「设置」-「招聘官网设置」-「申请表」中确认是否必填。 - 请求参数中的时间字段 (start_time/end_time 等)，时间格式为毫秒时间戳，类型均为 bigint。 ## 请求 基本 |   ---|--- HTTP URL | https://open.feishu.cn/open-apis/hire/v1/websites/:website_id/deliveries/create_by_resume HTTP Method | POST 接口频率限制 | [1000 次/分钟、50 次/秒](https://open.feishu.cn/document/ukTMukTMukTM/uUzN04SN3QjL1cDN) 支持的应用类型 | Custom App 权限要求
**调用该 API 所需的权限。开启其中任意一项权限即可调用** | 更新官网投递信息(hire:site_application) 字段权限要求 | **注意事项**：该接口返回体中存在下列敏感字段，仅当开启对应的权限后才会返回；如果无需获取这些字段，则不建议申请
获取用户 user ID(contact:user.employee_id:readonly) ### 请求头 名称 | 类型 | 必填 | 描述 ---|---|---|--- Authorization | string | 是 | `tenant_access_token`
**值格式**："Bearer `access_token`"
**示例值**："Bearer t-7f1bcd13fc57d46bac21793a18e560"
[了解更多：如何选择与获取 access token](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-choose-which-type-of-token-to-use) Content-Type | string | 是 | **固定值**："application/json; charset=utf-8" ### 路径参数 名称 | 类型 | 描述 ---|---|--- website_id | string | 官网 ID，可通过[获取招聘官网列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/website/list)获取
**示例值**："1618209327096" ### 查询参数 名称 | 类型 | 必填 | 描述 ---|---|---|--- user_id_type | string | 否 | 用户 ID 类型
**示例值**：open_id
**可选值有**：
- open_id：标识一个用户在某个应用中的身份。同一个用户在不同应用中的 Open ID 不同。[了解更多：如何获取 Open ID](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-openid)
- union_id：标识一个用户在某个应用开发商下的身份。同一用户在同一开发商下的应用中的 Union ID 是相同的，在不同开发商下的应用中的 Union ID 是不同的。通过 Union ID，应用开发商可以把同个用户在多个应用中的身份关联起来。[了解更多：如何获取 Union ID？](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-union-id)
- user_id：标识一个用户在某个租户内的身份。同一个用户在租户 A 和租户 B 内的 User ID 是不同的。在同一个租户内，一个用户的 User ID 在所有应用（包括商店应用）中都保持一致。User ID 主要用于在不同的应用间打通用户数据。[了解更多：如何获取 User ID？](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-user-id)
**默认值**：`open_id`
**当值为 `user_id`，字段权限要求**：
获取用户 user ID(contact:user.employee_id:readonly) ### 请求体 名称 | 类型 | 必填 | 描述 ---|---|---|--- job_post_id | string | 是 | 职位广告 ID，可通过[搜索招聘官网下的职位广告列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/website-job_post/search)或者[获取招聘官网下的职位广告列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/website-job_post/list)获取
**示例值**："6960663240925956636" resume | website_delivery_resume | 是 | 人才信息 internship_list | website_delivery_internship\[\] | 否 | 实习经历 desc | string | 否 | 实习经历描述
**示例值**："在抖音工作实习3个月，表现优秀" end_time | int | 否 | 结束时间，毫秒时间戳，如果是「至今」可传值 -1
**示例值**：1618500278667 start_time | int | 否 | 开始时间，毫秒时间戳
**示例值**：1609430400000 title | string | 否 | 职位名称
**示例值**："后端研发实习生" company | string | 否 | 公司名称
**示例值**："抖音公司" customized_data | website_delivery_customized_data\[\] | 否 | 自定义字段 object_id | string | 否 | 自定义字段 ID，可通过[获取人才字段](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/talent_object/query)获取
**示例值**："6960663240925956649" value | string | 否 | 自定义字段值，请参考本文「自定义字段数据格式说明」
**示例值**："AA" basic_info | website_delivery_basic_info | 是 | 基本信息 nationality_id | string | 否 | 国家码，可通过[查询地点列表](https://open.larkoffice.com/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/location/query)获取
**示例值**："CN_1" start_work_time | int | 否 | 起始工作时间，毫秒时间戳
**示例值**：1609430400000 current_home_address | string | 否 | 家庭住址
**示例值**："成都" hometown_city_code | string | 否 | 家乡，可通过[查询地点列表](https://open.larkoffice.com/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/location/query)获取
**示例值**："CT_159" mobile_country_code | string | 否 | 手机国家代码，可通过[查询地点列表](https://open.larkoffice.com/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/location/query)获取
**示例值**："CN_1" identification | website_delivery_identification | 否 | 身份证件 identification_number | string | 否 | 身份证件号码
**示例值**："11002030131312312" identification_type | int | 否 | 身份证件类型
**示例值**：1
**可选值有**：
- 1：中国 - 居民身份证
- 2：护照
- 3：中国 - 港澳居民居住证
- 4：中国 - 台湾居民来往大陆通行证
- 5：其他
- 6：中国 - 港澳居民来往内地通行证
- 9：中国 - 台湾居民居住证 marital_status | int | 否 | 婚姻状况
**示例值**：1
**可选值有**：
- 1：已婚
- 2：未婚 mobile | string | 否 | 电话
**示例值**："182900291190" current_city_code | string | 否 | 所在城市，可通过[查询地点列表](https://open.larkoffice.com/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/location/query)获取
**示例值**："CT_11" experience_years | int | 否 | 工作年限
**示例值**：3 gender | int | 否 | 性别
**示例值**：1
**可选值有**：
- 1：男
- 2：女
- 3：其他 birthday | int | 否 | 出生日期，毫秒时间戳
**示例值**：1609430400000 name | string | 是 | 姓名
**示例值**："张三" preferred_city_code_list | string\[\] | 否 | 意向城市列表，可通过[查询地点列表](https://open.larkoffice.com/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/location/query)获取
**示例值**：["CT_12"] resume_source_id | string | 否 | 简历来源，可通过[获取简历来源列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/resume_source/list)获取
**示例值**："6982104077248219436" age | int | 否 | 年龄
**示例值**：25 customized_data | website_delivery_customized_data\[\] | 否 | 自定义字段 object_id | string | 否 | 自定义字段 ID，可通过[获取人才字段](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/talent_object/query)获取
**示例值**："6960663240925956649" value | string | 否 | 自定义字段值，请参考本文「自定义字段数据格式说明」。
**示例值**："AA" email | string | 否 | 邮箱
**示例值**："foo@bytedance.com" education_list | website_delivery_education\[\] | 否 | 教育经历 education_type | int | 否 | 学历类型
**示例值**：1
**可选值有**：
- 1：非中国大陆
- 2：统招全日制
- 3：非全日制
- 4：自考
- 5：其他 end_time | int | 否 | 结束时间 ，毫秒时间戳，如果是「至今」可传值 -1。请注意：若传值-1，
投递创建成功后在系统中可正常查看，但若编辑则需要填一个具体时间
**示例值**：1618500278663 end_time_v2 | int | 否 | 结束时间（新），毫秒时间戳，无「至今」传值。
建议使用此字段，避免模糊的毕业时间影响候选人筛选
**示例值**：1618500278663 field_of_study | string | 否 | 专业
**示例值**："汉语言文学" school | string | 否 | 学校
**示例值**："香港中文大学" start_time | int | 否 | 开始时间，毫秒时间戳
**示例值**：1609430400000 academic_ranking | int | 否 | 专业排名
**示例值**：5
**可选值有**：
- 5：前 5 %
- 10：前 10 %
- 20：前 20 %
- 30：前 30 %
- 50：前 50 %
- 51：其他 customized_data | website_delivery_customized_data\[\] | 否 | 自定义字段 object_id | string | 否 | 自定义字段 ID，可通过[获取人才字段](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/talent_object/query)获取
**示例值**："6960663240925956649" value | string | 否 | 自定义字段值，请参考本文「自定义字段数据格式说明」
**示例值**："AA" degree | int | 否 | 学位
**示例值**：1
**可选值有**：
- 1：小学
- 2：初中
- 3：专职
- 4：高中
- 5：大专
- 6：本科
- 7：硕士
- 8：博士
- 9：其他 self_evaluation | website_delivery_self_evaluation | 否 | 自我评价 content | string | 否 | 评价内容
**示例值**："自我评价：平常心" customized_data | website_delivery_customized_data\[\] | 否 | 自定义字段 object_id | string | 否 | 自定义字段 ID，可通过[获取人才字段](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/talent_object/query)获取
**示例值**："6960663240925956649" value | string | 否 | 自定义字段值，请参考本文「自定义字段数据格式说明」
**示例值**："AA" career_list | website_delivery_career\[\] | 否 | 工作经历 desc | string | 否 | 工作经历描述
**示例值**："在抖音公司工作了5年，表现优秀" end_time | int | 否 | 结束时间, 毫秒时间戳，如果是「至今」可传值 -1
**示例值**：1618500278667 start_time | int | 否 | 开始时间，毫秒时间戳
**示例值**：1609430400000 title | string | 否 | 职位名称
**示例值**："后端研发工程师" company | string | 否 | 公司
**示例值**："抖音公司" customized_data | website_delivery_customized_data\[\] | 否 | 自定义字段 object_id | string | 否 | 自定义字段 ID，可通过[获取人才字段](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/talent_object/query)获取
**示例值**："6960663240925956649" value | string | 否 | 自定义字段值，请参考本文「自定义字段数据格式说明」
**示例值**："AA" customized_data | website_delivery_customized_data_parent\[\] | 否 | 自定义模块 object_id | string | 否 | 自定义模块ID，可通过[获取人才字段](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/talent_object/query)获取
**示例值**："6960663240925956651" children | website_delivery_customized_data\[\] | 否 | 字段列表 object_id | string | 否 | 自定义字段 ID，可通过[获取人才字段](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/talent_object/query)获取
**示例值**："6960663240925956649" value | string | 否 | 自定义字段值，请参考本文「自定义字段数据格式说明」
**示例值**："AA" resume_attachment_id | string | 否 | 简历附件ID，需通过[创建附件](https://open.feishu.cn/document/ukTMukTMukTM/uIDN1YjLyQTN24iM0UjN/create_attachment)生成
**示例值**："6960663240925956654" sns_list | website_delivery_sns\[\] | 否 | 社交账号 sns_type | int | 否 | 社交账号类型
**示例值**：1
**可选值有**：
- 1：领英
- 2：脉脉
- 3：微信
- 4：微博
- 5：Github
- 6：知乎
- 7：脸书
- 8：推特
- 9：Whatsapp
- 10：个人网站
- 11：QQ customized_data | website_delivery_customized_data\[\] | 否 | 自定义字段 object_id | string | 否 | 自定义字段 ID，可通过[获取人才字段](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/talent_object/query)获取
**示例值**："6960663240925956649" value | string | 否 | 自定义字段值，请参考本文「自定义字段数据格式说明」
**示例值**："AA" link | string | 否 | 社交账号链接
**示例值**："www.toutiao.com" works_list | website_delivery_works\[\] | 否 | 作品 desc | string | 否 | 作品描述
**示例值**："作品描述：研究生阶段发表了顶刊论文" link | string | 否 | 作品链接
**示例值**："www.toutiao.com" attachment | website_delivery_works_attachment | 否 | 附件 file_id | string | 否 | 文件ID，需通过[创建附件](https://open.feishu.cn/document/ukTMukTMukTM/uIDN1YjLyQTN24iM0UjN/create_attachment)生成
**示例值**："6982104077248219436" customized_data | website_delivery_customized_data\[\] | 否 | 自定义字段 object_id | string | 否 | 自定义字段 ID，可通过[获取人才字段](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/talent_object/query)获取
**示例值**："6960663240925956649" value | string | 否 | 自定义字段值，请参考本文「自定义字段数据格式说明」
**示例值**："AA" award_list | website_delivery_award\[\] | 否 | 获奖记录 customized_data | website_delivery_customized_data\[\] | 否 | 自定义字段 object_id | string | 否 | 自定义字段 ID，可通过[获取人才字段](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/talent_object/query)获取
**示例值**："6960663240925956649" value | string | 否 | 自定义字段值，请参考本文「自定义字段数据格式说明」
**示例值**："AA" desc | string | 否 | 获奖描述
**示例值**："ACM国际大学生程序设计竞赛" title | string | 否 | 奖项名称
**示例值**："ACM 亚洲区金牌" award_time | int | 否 | 获奖时间，毫秒时间戳
**示例值**：1609430400000 project_list | website_delivery_project\[\] | 否 | 项目经历 customized_data | website_delivery_customized_data\[\] | 否 | 自定义字段 object_id | string | 否 | 自定义字段 ID，可通过[获取人才字段](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/talent_object/query)获取
**示例值**："6960663240925956649" value | string | 否 | 自定义字段值，请参考本文「自定义字段数据格式说明」
**示例值**："AA" desc | string | 否 | 项目描述
**示例值**："项目描述：课程管理系统" end_time | int | 否 | 结束时间，毫秒时间戳，如果是「至今」可传值-1
**示例值**：1618500278669 link | string | 否 | 项目链接
**示例值**："www.toutiao.com" name | string | 否 | 项目名称
**示例值**："大学生课程设计" role | string | 否 | 项目角色
**示例值**："核心开发" start_time | int | 否 | 开始时间，毫秒时间戳
**示例值**：1609430400000 language_list | website_delivery_language\[\] | 否 | 语言能力 customized_data | website_delivery_customized_data\[\] | 否 | 自定义字段 object_id | string | 否 | 自定义字段 ID，可通过[获取人才字段](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/talent_object/query)获取
**示例值**："6960663240925956649" value | string | 否 | 自定义字段值，请参考本文「自定义字段数据格式说明」
**示例值**："AA" language | int | 否 | 语言
**示例值**：1
**可选值有**：
- 1：英语
- 2：法语
- 3：日语
- 4：韩语
- 5：德语
- 6：俄语
- 7：西班牙语
- 8：葡萄牙语
- 9：阿拉伯语
- 10：印地语
- 11：印度斯坦语
- 12：孟加拉语
- 13：豪萨语
- 14：旁遮普语
- 15：波斯语
- 16：斯瓦西里语
- 17：泰卢固语
- 18：土耳其语
- 19：意大利语
- 20：爪哇语
- 21：泰米尔语
- 22：马拉地语
- 23：越南语
- 24：普通话
- 25：粤语 proficiency | int | 否 | 熟悉程度
**示例值**：1
**可选值有**：
- 1：入门
- 2：日常会话
- 3：商务会话
- 4：无障碍沟通
- 5：母语 user_id | string | 是 | 官网用户 ID，需通过[新建招聘官网用户](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/website-site_user/create)生成
**示例值**："6960663240925956634" application_preferred_city_code_list | string\[\] | 否 | 意向投递城市列表，可通过[查询地点列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/location/query)获取
**示例值**：["6960663240925956636"] channel_id | string | 否 | 官网推广渠道 ID，可通过[获取招聘官网推广渠道列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/website-channel/list)获取
**示例值**："6891560630172518670" ### 自定义字段数据格式说明 - 单选：`"1"` - 多选：`"[\"1\", \"2\"]"` - 单行：`"单行文本"` - 多行：`"多行文本"` - 数字：`"1"` - 月份选择：`"1627379423000"` - 年份选择：`"1627379423000"` - 日期选择：`"1627379423000"` - 附件：`"[{\"file_id\": \"7250161881116838204\"},{\"file_id\": \"7250161808660826429\"}]"` - 时间段：`"[\"1577808000000\", \"1612108800000\"]"` ### 请求体示例 ```json { "job_post_id": "6960663240925956636", "resume": { "internship_list": [ { "desc": "在抖音工作实习3个月，表现优秀", "end_time": 1618500278667, "start_time": 1609430400000, "title": "后端研发实习生", "company": "抖音公司", "customized_data": [ { "object_id": "6960663240925956649", "value": "AA" } ] } ], "basic_info": { "nationality_id": "CN_1", "start_work_time": 1609430400000, "current_home_address": "成都", "hometown_city_code": "CT_159", "mobile_country_code": "CN_1", "identification": { "identification_number": "11002030131312312", "identification_type": 1 }, "marital_status": 1, "mobile": "182900291190", "current_city_code": "CT_11", "experience_years": 3, "gender": 1, "birthday": 1609430400000, "name": "张三", "preferred_city_code_list": [ "CT_12" ], "resume_source_id": "6982104077248219436", "age": 25, "customized_data": [ { "object_id": "6960663240925956649", "value": "AA" } ], "email": "foo@bytedance.com" }, "education_list": [ { "education_type": 1, "end_time": 1618500278663, "end_time_v2": 1618500278663, "field_of_study": "汉语言文学", "school": "香港中文大学", "start_time": 1609430400000, "academic_ranking": 5, "customized_data": [ { "object_id": "6960663240925956649", "value": "AA" } ], "degree": 1 } ], "self_evaluation": { "content": "自我评价：平常心", "customized_data": [ { "object_id": "6960663240925956649", "value": "AA" } ] }, "career_list": [ { "desc": "在抖音公司工作了5年，表现优秀", "end_time": 1618500278667, "start_time": 1609430400000, "title": "后端研发工程师", "company": "抖音公司", "customized_data": [ { "object_id": "6960663240925956649", "value": "AA" } ] } ], "customized_data": [ { "object_id": "6960663240925956651", "children": [ { "object_id": "6960663240925956649", "value": "AA" } ] } ], "resume_attachment_id": "6960663240925956654", "sns_list": [ { "sns_type": 1, "customized_data": [ { "object_id": "6960663240925956649", "value": "AA" } ], "link": "www.toutiao.com" } ], "works_list": [ { "desc": "作品描述：研究生阶段发表了顶刊论文", "link": "www.toutiao.com", "attachment": { "file_id": "6982104077248219436" }, "customized_data": [ { "object_id": "6960663240925956649", "value": "AA" } ] } ], "award_list": [ { "customized_data": [ { "object_id": "6960663240925956649", "value": "AA" } ], "desc": "ACM国际大学生程序设计竞赛", "title": "ACM 亚洲区金牌", "award_time": 1609430400000 } ], "project_list": [ { "customized_data": [ { "object_id": "6960663240925956649", "value": "AA" } ], "desc": "项目描述：课程管理系统", "end_time": 1618500278669, "link": "www.toutiao.com", "name": "大学生课程设计", "role": "核心开发", "start_time": 1609430400000 } ], "language_list": [ { "customized_data": [ { "object_id": "6960663240925956649", "value": "AA" } ], "language": 1, "proficiency": 1 } ] }, "user_id": "6960663240925956634", "application_preferred_city_code_list": [ "6960663240925956636" ], "channel_id": "6891560630172518670" } ``` ## 响应 ### 响应体 名称 | 类型 | 描述 ---|---|--- code | int | 错误码，非 0 表示失败 msg | string | 错误描述 data | \- | \- delivery | website_delivery_dto | 官网投递信息 application_id | string | 招聘投递 ID，可通过[获取投递信息](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/application/get)获取详细信息 id | string | 官网投递ID job_id | string | 职位 ID job_post_id | string | 职位广告 ID portal_resume_id | string | 简历 ID user_id | string | 官网用户 ID talent_id | string | 人才 ID，详情可参考[获取人才信息 ](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/hire-v2/talent/get) ### 响应体示例 ```json { "code": 0, "msg": "ok", "data": { "delivery": { "application_id": "6960663240925956657", "id": "6960663240925956655", "job_id": "6960663240925956659", "job_post_id": "6960663240925956658", "portal_resume_id": "6960663240925956660", "user_id": "6960663240925956656", "talent_id": "7095600054216542508" } } } ``` ### 错误码 HTTP状态码 | 错误码 | 描述 | 排查建议 ---|---|---|--- 500 | 1002001 | 系统错误 | 请根据实际报错信息定位或咨询[技术支持](https://applink.feishu.cn/TLJpeNdW) 400 | 1002002 | 参数错误 | 检查参数是否正确，例如类型，大小 400 | 1002511 | 候选人的投递次数已达到上限 | 请联系调用方招聘系统管理员，确认最大投递次数 400 | 1002513 | 请提供准确的毕业时间 | 请检查毕业结束时间字段`resume.education_list.end_time_v2`