飞书开放平台 Server API 文档

主题

新建招聘官网投递 ​

新建招聘官网投递。

注意事项 ​

  • 请求参数中邮箱/电话等字段请在「飞书招聘」-「设置」-「招聘官网设置」-「申请表」中确认是否必填。
  • 请求参数中的时间字段 (start_time/end_time 等)，时间格式为毫秒时间戳，类型均为 bigint。

请求 ​

项目值
HTTP URLhttps://open.feishu.cn/open-apis/hire/v1/websites/:website_id/deliveries/create_by_resume
HTTP MethodPOST
接口频率限制1000 次/分钟、50 次/秒
支持的应用类型custom
权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用hire:site_application 更新官网投递信息
字段权限要求> 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"

路径参数 ​

名称类型描述
website_idstring官网 ID，可通过获取招聘官网列表获取
示例值："1618209327096"

查询参数 ​

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

请求体 ​

名称类型必填描述
job_post_idstring是职位广告 ID，可通过搜索招聘官网下的职位广告列表或者获取招聘官网下的职位广告列表获取
示例值："6960663240925956636"
resumewebsite_delivery_resume是人才信息
  └ internship_listwebsite_delivery_internship\[\]否实习经历
    └ descstring否实习经历描述
示例值："在抖音工作实习3个月，表现优秀"
    └ end_timeint否结束时间，毫秒时间戳，如果是「至今」可传值 -1
示例值：1618500278667
    └ start_timeint否开始时间，毫秒时间戳
示例值：1609430400000
    └ titlestring否职位名称
示例值："后端研发实习生"
    └ companystring否公司名称
示例值："抖音公司"
    └ customized_datawebsite_delivery_customized_data\[\]否自定义字段
      └ object_idstring否自定义字段 ID，可通过获取人才字段获取
示例值："6960663240925956649"
      └ valuestring否自定义字段值，请参考本文「自定义字段数据格式说明」
示例值："AA"
  └ basic_infowebsite_delivery_basic_info是基本信息
    └ nationality_idstring否国家码，可通过查询地点列表获取
示例值："CN_1"
    └ start_work_timeint否起始工作时间，毫秒时间戳
示例值：1609430400000
    └ current_home_addressstring否家庭住址
示例值："成都"
    └ hometown_city_codestring否家乡，可通过查询地点列表获取
示例值："CT_159"
    └ mobile_country_codestring否手机国家代码，可通过查询地点列表获取
示例值："CN_1"
    └ identificationwebsite_delivery_identification否身份证件
      └ identification_numberstring否身份证件号码
示例值："11002030131312312"
      └ identification_typeint否身份证件类型
示例值：1
可选值有：
- 1: 中国 - 居民身份证 - 2: 护照 - 3: 中国 - 港澳居民居住证 - 4: 中国 - 台湾居民来往大陆通行证 - 5: 其他 - 6: 中国 - 港澳居民来往内地通行证 - 9: 中国 - 台湾居民居住证
    └ marital_statusint否婚姻状况
示例值：1
可选值有：
- 1: 已婚 - 2: 未婚
    └ mobilestring否电话
示例值："182900291190"
    └ current_city_codestring否所在城市，可通过查询地点列表获取
示例值："CT_11"
    └ experience_yearsint否工作年限
示例值：3
    └ genderint否性别
示例值：1
可选值有：
- 1: 男 - 2: 女 - 3: 其他
    └ birthdayint否出生日期，毫秒时间戳
示例值：1609430400000
    └ namestring是姓名
示例值："张三"
    └ preferred_city_code_liststring\[\]否意向城市列表，可通过查询地点列表获取
示例值：["CT_12"]
    └ resume_source_idstring否简历来源，可通过获取简历来源列表获取
示例值："6982104077248219436"
    └ ageint否年龄
示例值：25
    └ customized_datawebsite_delivery_customized_data\[\]否自定义字段
      └ object_idstring否自定义字段 ID，可通过获取人才字段获取
示例值："6960663240925956649"
      └ valuestring否自定义字段值，请参考本文「自定义字段数据格式说明」。
示例值："AA"
    └ emailstring否邮箱
示例值："foo@bytedance.com"
  └ education_listwebsite_delivery_education\[\]否教育经历
    └ education_typeint否学历类型
示例值：1
可选值有：
- 1: 非中国大陆 - 2: 统招全日制 - 3: 非全日制 - 4: 自考 - 5: 其他
    └ end_timeint否结束时间 ，毫秒时间戳，如果是「至今」可传值 -1。请注意：若传值-1， 投递创建成功后在系统中可正常查看，但若编辑则需要填一个具体时间
示例值：1618500278663
    └ end_time_v2int否结束时间（新），毫秒时间戳，无「至今」传值。 建议使用此字段，避免模糊的毕业时间影响候选人筛选
示例值：1618500278663
    └ field_of_studystring否专业
示例值："汉语言文学"
    └ schoolstring否学校
示例值："香港中文大学"
    └ start_timeint否开始时间，毫秒时间戳
示例值：1609430400000
    └ academic_rankingint否专业排名
示例值：5
可选值有：
- 5: 前 5 % - 10: 前 10 % - 20: 前 20 % - 30: 前 30 % - 50: 前 50 % - 51: 其他
    └ customized_datawebsite_delivery_customized_data\[\]否自定义字段
      └ object_idstring否自定义字段 ID，可通过获取人才字段获取
示例值："6960663240925956649"
      └ valuestring否自定义字段值，请参考本文「自定义字段数据格式说明」
示例值："AA"
    └ degreeint否学位
示例值：1
可选值有：
- 1: 小学 - 2: 初中 - 3: 专职 - 4: 高中 - 5: 大专 - 6: 本科 - 7: 硕士 - 8: 博士 - 9: 其他
  └ self_evaluationwebsite_delivery_self_evaluation否自我评价
    └ contentstring否评价内容
示例值："自我评价：平常心"
    └ customized_datawebsite_delivery_customized_data\[\]否自定义字段
      └ object_idstring否自定义字段 ID，可通过获取人才字段获取
示例值："6960663240925956649"
      └ valuestring否自定义字段值，请参考本文「自定义字段数据格式说明」
示例值："AA"
  └ career_listwebsite_delivery_career\[\]否工作经历
    └ descstring否工作经历描述
示例值："在抖音公司工作了5年，表现优秀"
    └ end_timeint否结束时间, 毫秒时间戳，如果是「至今」可传值 -1
示例值：1618500278667
    └ start_timeint否开始时间，毫秒时间戳
示例值：1609430400000
    └ titlestring否职位名称
示例值："后端研发工程师"
    └ companystring否公司
示例值："抖音公司"
    └ customized_datawebsite_delivery_customized_data\[\]否自定义字段
      └ object_idstring否自定义字段 ID，可通过获取人才字段获取
示例值："6960663240925956649"
      └ valuestring否自定义字段值，请参考本文「自定义字段数据格式说明」
示例值："AA"
  └ customized_datawebsite_delivery_customized_data_parent\[\]否自定义模块
    └ object_idstring否自定义模块ID，可通过获取人才字段获取
示例值："6960663240925956651"
    └ childrenwebsite_delivery_customized_data\[\]否字段列表
      └ object_idstring否自定义字段 ID，可通过获取人才字段获取
示例值："6960663240925956649"
      └ valuestring否自定义字段值，请参考本文「自定义字段数据格式说明」
示例值："AA"
  └ resume_attachment_idstring否简历附件ID，需通过创建附件生成
示例值："6960663240925956654"
  └ sns_listwebsite_delivery_sns\[\]否社交账号
    └ sns_typeint否社交账号类型
示例值：1
可选值有：
- 1: 领英 - 2: 脉脉 - 3: 微信 - 4: 微博 - 5: Github - 6: 知乎 - 7: 脸书 - 8: 推特 - 9: Whatsapp - 10: 个人网站 - 11: QQ
    └ customized_datawebsite_delivery_customized_data\[\]否自定义字段
      └ object_idstring否自定义字段 ID，可通过获取人才字段获取
示例值："6960663240925956649"
      └ valuestring否自定义字段值，请参考本文「自定义字段数据格式说明」
示例值："AA"
    └ linkstring否社交账号链接
示例值："www.toutiao.com"
  └ works_listwebsite_delivery_works\[\]否作品
    └ descstring否作品描述
示例值："作品描述：研究生阶段发表了顶刊论文"
    └ linkstring否作品链接
示例值："www.toutiao.com"
    └ attachmentwebsite_delivery_works_attachment否附件
      └ file_idstring否文件ID，需通过创建附件生成
示例值："6982104077248219436"
    └ customized_datawebsite_delivery_customized_data\[\]否自定义字段
      └ object_idstring否自定义字段 ID，可通过获取人才字段获取
示例值："6960663240925956649"
      └ valuestring否自定义字段值，请参考本文「自定义字段数据格式说明」
示例值："AA"
  └ award_listwebsite_delivery_award\[\]否获奖记录
    └ customized_datawebsite_delivery_customized_data\[\]否自定义字段
      └ object_idstring否自定义字段 ID，可通过获取人才字段获取
示例值："6960663240925956649"
      └ valuestring否自定义字段值，请参考本文「自定义字段数据格式说明」
示例值："AA"
    └ descstring否获奖描述
示例值："ACM国际大学生程序设计竞赛"
    └ titlestring否奖项名称
示例值："ACM 亚洲区金牌"
    └ award_timeint否获奖时间，毫秒时间戳
示例值：1609430400000
  └ project_listwebsite_delivery_project\[\]否项目经历
    └ customized_datawebsite_delivery_customized_data\[\]否自定义字段
      └ object_idstring否自定义字段 ID，可通过获取人才字段获取
示例值："6960663240925956649"
      └ valuestring否自定义字段值，请参考本文「自定义字段数据格式说明」
示例值："AA"
    └ descstring否项目描述
示例值："项目描述：课程管理系统"
    └ end_timeint否结束时间，毫秒时间戳，如果是「至今」可传值-1
示例值：1618500278669
    └ linkstring否项目链接
示例值："www.toutiao.com"
    └ namestring否项目名称
示例值："大学生课程设计"
    └ rolestring否项目角色
示例值："核心开发"
    └ start_timeint否开始时间，毫秒时间戳
示例值：1609430400000
  └ language_listwebsite_delivery_language\[\]否语言能力
    └ customized_datawebsite_delivery_customized_data\[\]否自定义字段
      └ object_idstring否自定义字段 ID，可通过获取人才字段获取
示例值："6960663240925956649"
      └ valuestring否自定义字段值，请参考本文「自定义字段数据格式说明」
示例值："AA"
    └ languageint否语言
示例值：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: 粤语
    └ proficiencyint否熟悉程度
示例值：1
可选值有：
- 1: 入门 - 2: 日常会话 - 3: 商务会话 - 4: 无障碍沟通 - 5: 母语
user_idstring是官网用户 ID，需通过新建招聘官网用户生成
示例值："6960663240925956634"
application_preferred_city_code_liststring\[\]否意向投递城市列表，可通过查询地点列表获取
示例值：["6960663240925956636"]
channel_idstring否官网推广渠道 ID，可通过获取招聘官网推广渠道列表获取
示例值："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"
}

响应 ​

响应体 ​

名称类型描述
codeint错误码，非 0 表示失败
msgstring错误描述
data\--
  └ deliverywebsite_delivery_dto官网投递信息
    └ application_idstring招聘投递 ID，可通过获取投递信息获取详细信息
    └ idstring官网投递ID
    └ job_idstring职位 ID
    └ job_post_idstring职位广告 ID
    └ portal_resume_idstring简历 ID
    └ user_idstring官网用户 ID
    └ talent_idstring人才 ID，详情可参考获取人才信息

响应体示例 ​

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状态码错误码描述排查建议
5001002001系统错误请根据实际报错信息定位或咨询技术支持
4001002002参数错误检查参数是否正确，例如类型，大小
4001002511候选人的投递次数已达到上限请联系调用方招聘系统管理员，确认最大投递次数
4001002513请提供准确的毕业时间请检查毕业结束时间字段resume.education_list.end_time_v2

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

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