飞书开放平台 Server API 文档

主题

识别文件中的简历信息 ​

简历信息解析接口，支持PDF/DOCX/PNG/JPG四种文件类型的一次性的识别。文件大小需要小于30M。

Tip: 单租户限流：10QPS，同租户下的应用没有限流，共享本租户的 10QPS 限流

请求 ​

项目值
HTTP URLhttps://open.feishu.cn/open-apis/document_ai/v1/resume/parse
HTTP MethodPOST
接口频率限制10 次/秒
支持的应用类型custom,isv
权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用document_ai:resume:recognize 识别简历

请求头 ​

名称类型必填描述
Authorizationstring是tenant_access_token 值格式："Bearer access_token" 示例值："Bearer t-7f1bcd13fc57d46bac21793a18e560" 了解更多：如何选择与获取 access token
Content-Typestring是示例值："multipart/form-data; boundary=---7MA4YWxkTrZu0gW"

请求体 ​

名称类型必填描述
filefile是简历文件，支持 PDF / DOCX / PNG / JPG
示例值：file binary

请求体示例 ​

HTTP
---7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="file";
Content-Type: application/octet-stream


---7MA4YWxkTrZu0gW

响应 ​

响应体 ​

名称类型描述
codeint错误码，非 0 表示失败
msgstring错误描述
data\--
  └ resumesresume\[\]简历信息
    └ file_md5string文件标识ID，依据文件内容自动生成
    └ contentstring文本内容，当接口返回成功时，该字段才存在
    └ new_contentstring经过排序后的文本内容，当接口返回成功时，该字段才存在
    └ namestring名称
    └ emailstring邮箱
    └ mobilestring手机号码
    └ mobile_is_virtualboolean手机号码是否虚拟号码
    └ country_codestring手机号码国家编码
    └ educationsresume_education\[\]教育经历
      └ schoolstring学校名称
      └ start_datestring开始时间,格式：YYYY-MM-DD
      └ start_timestring开始时间,格式：YYYY-MM-DD,跟start_date值一样
      └ end_datestring结束时间,格式：YYYY-MM-DD
      └ end_timestring结束时间,格式：YYYY-MM-DD 或 “至今”，当值为“至今”时，end_date=="",值为其他时，end_date==end_time
      └ majorstring专业
      └ degreestring学历——小学、初中、中职、高中、专科、本科、硕士、博士、其他
      └ qualificationint学历对应ID
可选值有：
- 1: 小学 - 2: 初中 - 3: 中职 - 4: 高中 - 5: 专科 - 6: 本科 - 7: 硕士 - 8: 博士 - 9: 其他
    └ careersresume_career\[\]职业经历
      └ companystring公司名称
      └ start_datestring开始时间,格式：YYYY-MM-DD
      └ start_timestring始时间,格式：YYYY-MM-DD,跟start_date值一样
      └ end_datestring结束时间,格式：YYYY-MM-DD
      └ end_timestring结束时间,格式：YYYY-MM-DD 或 “至今”，当值为“至今”时，end_date=="",值为其他时，end_date==end_time
      └ titlestring职位
      └ typeint工作类型
可选值有：
- 1: 实习 - 2: 全职
      └ type_strstring工作类型——'实习'、'全职'
      └ job_descriptionstring工作描述
    └ projectsresume_project\[\]项目经历
      └ namestring项目名称
      └ titlestring项目岗位
      └ start_datestring开始时间,格式：YYYY-MM-DD
      └ start_timestring开始时间,格式：YYYY-MM-DD,跟start_date值一样
      └ end_datestring结束时间,格式：YYYY-MM-DD
      └ end_timestring结束时间,格式：YYYY-MM-DD 或 “至今”，当值为“至今”时，end_date=="",值
      └ descriptionstring项目描述
    └ work_yearint工作年限，为空表示工作年限未知，数字单位为年，整数
    └ date_of_birthstring生日，格式YYYY-MM-DD
    └ genderint性别
可选值有：
- 0: 未知 - 1: 男性 - 2: 女性
    └ willing_positionsstring\[\]希望获得的职位列表
    └ current_locationstring当前工作地点(城市)
    └ willing_locationsstring\[\]希望工作地点列表
    └ home_locationstring家乡(城市)
    └ languagesresume_language\[\]语言
      └ levelint语言等级
      └ descriptionstring语言描述
    └ awardsresume_award\[\]获奖
      └ awardstring奖项
      └ datestring获奖时间，格式：YYYY
      └ descriptionstring描述
    └ certificatesresume_certificate\[\]证书
      └ namestring证书名称
      └ descstring描述
    └ competitionsresume_competition\[\]竞赛
      └ namestring竞赛名称
      └ descstring描述
    └ self_evaluationstring自我评价
    └ urlsstring\[\]链接列表
    └ social_linksstring\[\]社交链接

响应体示例 ​

json
{
    "code": 0,
    "msg": "success",
    "data": {
        "resumes": [
            {
                "file_md5": "825c59042dxxxxx3ff90b45xxxxx88",
                "content": "XX负责行政人事管理和日常事务...",
                "new_content": "XX负责行政人事管理和日常事务...",
                "name": "张三",
                "email": "zhangsan.1111@company.com",
                "mobile": "13600000000",
                "mobile_is_virtual": false,
                "country_code": "86",
                "educations": [
                    {
                        "school": "A大学",
                        "start_date": "2020-01-03",
                        "start_time": "2020-01-03",
                        "end_date": "2021-01-03",
                        "end_time": "至今",
                        "major": "XX工程",
                        "degree": "本科",
                        "qualification": 6
                    }
                ],
                "careers": [
                    {
                        "company": "XX公司",
                        "start_date": "2022-01-03",
                        "start_time": "2022-01-03",
                        "end_date": "2023-01-03",
                        "end_time": "2023-01-03",
                        "title": "XXX工程师",
                        "type": 2,
                        "type_str": "全职",
                        "job_description": "负责XXX开发..."
                    }
                ],
                "projects": [
                    {
                        "name": "XX项目",
                        "title": "客户端研发",
                        "start_date": "2023-01-03",
                        "start_time": "2023-01-03",
                        "end_date": "2023-01-04",
                        "end_time": "2023-01-04",
                        "description": "XXX项目是一个..."
                    }
                ],
                "work_year": 5,
                "date_of_birth": "1995-01-01",
                "gender": 1,
                "willing_positions": [
                    "XX岗位"
                ],
                "current_location": "上海",
                "willing_locations": [
                    "上海"
                ],
                "home_location": "上海",
                "languages": [
                    {
                        "level": 2,
                        "description": "英语四级:600"
                    }
                ],
                "awards": [
                    {
                        "award": "XXX大赛奖项",
                        "date": "2015",
                        "description": "曾获XXX大赛奖项..."
                    }
                ],
                "certificates": [
                    {
                        "name": "XXX证书",
                        "desc": "曾获得XXX证书..."
                    }
                ],
                "competitions": [
                    {
                        "name": "XXX竞赛",
                        "desc": "曾参加XXX竞赛..."
                    }
                ],
                "self_evaluation": "我是一个...",
                "urls": [
                    "https://github.com/"
                ],
                "social_links": [
                    "https://github.com/"
                ]
            }
        ]
    }
}

错误码 ​

HTTP状态码错误码描述排查建议
4002110001param is invalid输入文件错误，参考文档检查输入参数
4002110002No resume detected未检测出简历文件，参考文档检查输入文件是否有效
5002110010Internal error, please try later.后端服务异常或网络异常，可重新请求
4002110003You have reached the Intelligent document parsing limit. To continue using this function, please contact sales to purchase more.智能文档解析次数已达使用上限，如需继续使用，请联系销售购买

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

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