文档中心 > API类目 > 钉钉API

dingtalk.oapi.ats.resume.add (添加简历信息)

添加简历信息

公共参数

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://gw.api.taobao.com/router/rest	https://eco.taobao.com/router/rest

名称	类型	是否必须	描述
access_token	String	是	钉钉提供的授权Token，想了解详情，ISV开发者请点击这里，企业开发者请点击这里。若有疑问，咨询邮箱dingding_open_dingtalk#list.alibaba-inc.com。

请求参数

名称	类型	是否必须	示例值	描述
param	CollResumeMailParam	必须		简历文件参数
└ matched_jobs String [] 可选 [xxxx,xxxx,xxxx] 匹配到的职位列表 └ channel String 必须 51job 渠道来源，接入前请提前沟通 resume_detail_info ResumeDetailInfo 可选结构化的简历详情 └ name String 可选张三姓名，必传 └ phone_num String 可选 18668421234 电话，必传 └ email String 可选 123@mail.com 邮箱地址 └ sex String 可选男性男性，女性 └ birth String 可选 2010-01 出生日期 └ graduate_time String 可选 2010-01 毕业时间 └ begin_work_time String 可选 2010-01 开始工作时间 └ nationality String 可选中国国籍 └ married String 可选已婚已婚，未婚，离婚 └ native_place String 可选浙江籍贯 └ now_location String 可选浙江省杭州市先居住地 └ forward_location String 可选浙江省杭州市期望工作地 └ school String 可选浙江大学毕业院校 └ education String 可选本科小学，初中，高中，中专，大专，本科，硕士，博士，其他 └ advanced_degree String 可选理学学士学位 └ student_type String 可选全日制学历情况 └ school_type String 可选 985 学校类别 └ speciality String 可选计算机科学与技术专业 └ salary String 可选 1000 当前薪资 └ aim_salary String 可选 2000 期望薪资 └ title_standard String 可选开发工程师职位名称 └ vocation_standard String 可选互联网行业名称 └ political String 可选党员政治面貌 └ job_status String 可选求职中求职状态 └ grade_of_english String 可选 6级英语等级 education_info_list EducationInfo [] 可选教育经历 └ start_date String 可选 2010-01 开始时间 └ end_date String 可选 2010-01 结束时间 └ school String 可选浙江大学学校名称 └ speciality String 可选计算机科学与技术专业 └ education String 可选本科学历 └ summary String 可选专业GPA3.2,一等奖学金详细介绍 experience_info_list ExperienceInfo [] 可选工作经历 └ start_date String 可选 2010-01 开始时间 └ end_date String 可选 2010-01 结束时间 └ company String 可选阿里巴巴公司名称 └ title String 可选开发工程师职位名称 └ summary String 可选负责xxx项目的研发工作，取得了xx成果工作内容 training_info_list TrainingInfo [] 可选培训经历 └ start_date String 可选 2010-01 开始时间 └ end_date String 可选 2010-01 结束时间 └ training_institution String 可选新东方培训机构名称 └ certificate String 可选高级厨师证书所获证书 └ description_in_details String 可选川菜，粤菜，维扬菜，煎炸蒸煮培训详情 project_info_list ProjectInfo [] 可选项目经历 └ start_date String 可选 2010-01 开始时间 └ end_date String 可选 2010-01 结束时间 └ project_name String 可选 xxx项目项目名称 └ project_description String 可选项目描述项目描述 └ opt_user_id String 可选 userId123 用户userId resume_file ResumeFileStoreVo 可选简历文件信息 └ download_url String 可选 xxxx 下载地址 └ file_type String 可选 pdf 文件类型 └ file_name String 可选 xxx.pdf 文件名，需要带后缀 origin_mail MailContent 可选原始邮件信息，可选 └ received_time String 可选 15984483611280 收件时间，时间戳毫秒 └ mail_id String 可选 xxxx 邮件id └ from_mail_alias String 可选 xxx 发件人姓名 └ mail_address String 可选 xxxx 邮件地址，可选 └ title String 可选 xxxx 邮件标题，可选 └ body_html String 可选 xxxxx 邮件正文，可选 └ from_mail_address String 可选 xxxx 发件人邮件地址，可选 └ virtual_phone_number_flag Boolean 可选 true 是否是虚拟手机号 └ resume_channel_url String 可选 www.alibaba.com 虚拟手机号简历跳转到渠道链接
biz_code	String	必须	ddats	业务唯一标识，接入前请提前沟通

响应参数

名称	类型	示例值	描述
errmsg	String	无访问权限	错误信息
errcode	Number	400020	错误码
result	TopCollectResumeResult	{}	处理结果
└ resume_id String abcd1234 简历id └ pc_jump_url String xxxx pc端跳转地址 └ mobile_jump_url String xxxx 移动端跳转地址

请求示例

JAVA
.NET
PHP
CURL
Python
C/C++
NodeJS

DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/ats/resume/add");
OapiAtsResumeAddRequest req = new OapiAtsResumeAddRequest();
CollResumeMailParam obj1 = new CollResumeMailParam();
obj1.setMatchedJobs("xxxx,xxxx,xxxx");
obj1.setChannel("51job");
ResumeDetailInfo obj2 = new ResumeDetailInfo();
obj2.setName("张三");
obj2.setPhoneNum("18668421234");
obj2.setEmail("123@mail.com");
obj2.setSex("男性");
obj2.setBirth("2010-01");
obj2.setGraduateTime("2010-01");
obj2.setBeginWorkTime("2010-01");
obj2.setNationality("中国");
obj2.setMarried("已婚");
obj2.setNativePlace("浙江");
obj2.setNowLocation("浙江省杭州市");
obj2.setForwardLocation("浙江省杭州市");
obj2.setSchool("浙江大学");
obj2.setEducation("本科");
obj2.setAdvancedDegree("理学学士");
obj2.setStudentType("全日制");
obj2.setSchoolType("985");
obj2.setSpeciality("计算机科学与技术");
obj2.setSalary("1000");
obj2.setAimSalary("2000");
obj2.setTitleStandard("开发工程师");
obj2.setVocationStandard("互联网");
obj2.setPolitical("党员");
obj2.setJobStatus("求职中");
obj2.setGradeOfEnglish("6级");
List<EducationInfo> list4 = new ArrayList<EducationInfo>();
EducationInfo obj5 = new EducationInfo();
list4.add(obj5);
obj5.setStartDate("2010-01");
obj5.setEndDate("2010-01");
obj5.setSchool("浙江大学");
obj5.setSpeciality("计算机科学与技术");
obj5.setEducation("本科");
obj5.setSummary("专业GPA3.2,一等奖学金");
obj2.setEducationInfoList(list4);
List<ExperienceInfo> list7 = new ArrayList<ExperienceInfo>();
ExperienceInfo obj8 = new ExperienceInfo();
list7.add(obj8);
obj8.setStartDate("2010-01");
obj8.setEndDate("2010-01");
obj8.setCompany("阿里巴巴");
obj8.setTitle("开发工程师");
obj8.setSummary("负责xxx项目的研发工作，取得了xx成果");
obj2.setExperienceInfoList(list7);
List<TrainingInfo> list10 = new ArrayList<TrainingInfo>();
TrainingInfo obj11 = new TrainingInfo();
list10.add(obj11);
obj11.setStartDate("2010-01");
obj11.setEndDate("2010-01");
obj11.setTrainingInstitution("新东方");
obj11.setCertificate("高级厨师证书");
obj11.setDescriptionInDetails("川菜，粤菜，维扬菜，煎炸蒸煮");
obj2.setTrainingInfoList(list10);
List<ProjectInfo> list13 = new ArrayList<ProjectInfo>();
ProjectInfo obj14 = new ProjectInfo();
list13.add(obj14);
obj14.setStartDate("2010-01");
obj14.setEndDate("2010-01");
obj14.setProjectName("xxx项目");
obj14.setProjectDescription("项目描述");
obj2.setProjectInfoList(list13);
obj1.setResumeDetailInfo(obj2);
obj1.setOptUserId("userId123");
ResumeFileStoreVo obj15 = new ResumeFileStoreVo();
obj15.setDownloadUrl("xxxx");
obj15.setFileType("pdf");
obj15.setFileName("xxx.pdf");
obj1.setResumeFile(obj15);
MailContent obj16 = new MailContent();
obj16.setReceivedTime("15984483611280");
obj16.setMailId("xxxx");
obj16.setFromMailAlias("xxx");
obj16.setMailAddress("xxxx");
obj16.setTitle("xxxx");
obj16.setBodyHtml("xxxxx");
obj16.setFromMailAddress("xxxx");
obj1.setOriginMail(obj16);
obj1.setVirtualPhoneNumberFlag(true);
obj1.setResumeChannelUrl("www.alibaba.com");
req.setParam(obj1);
req.setBizCode("ddats");
OapiAtsResumeAddResponse rsp = client.execute(req, access_token);
System.out.println(rsp.getBody());

IDingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/ats/resume/add");
OapiAtsResumeAddRequest req = new OapiAtsResumeAddRequest();
OapiAtsResumeAddRequest.CollResumeMailParamDomain obj1 = new OapiAtsResumeAddRequest.CollResumeMailParamDomain();
obj1.MatchedJobs = "xxxx,xxxx,xxxx";
obj1.Channel = "51job";
OapiAtsResumeAddRequest.ResumeDetailInfoDomain obj2 = new OapiAtsResumeAddRequest.ResumeDetailInfoDomain();
obj2.Name = "张三";
obj2.PhoneNum = "18668421234";
obj2.Email = "123@mail.com";
obj2.Sex = "男性";
obj2.Birth = "2010-01";
obj2.GraduateTime = "2010-01";
obj2.BeginWorkTime = "2010-01";
obj2.Nationality = "中国";
obj2.Married = "已婚";
obj2.NativePlace = "浙江";
obj2.NowLocation = "浙江省杭州市";
obj2.ForwardLocation = "浙江省杭州市";
obj2.School = "浙江大学";
obj2.Education = "本科";
obj2.AdvancedDegree = "理学学士";
obj2.StudentType = "全日制";
obj2.SchoolType = "985";
obj2.Speciality = "计算机科学与技术";
obj2.Salary = "1000";
obj2.AimSalary = "2000";
obj2.TitleStandard = "开发工程师";
obj2.VocationStandard = "互联网";
obj2.Political = "党员";
obj2.JobStatus = "求职中";
obj2.GradeOfEnglish = "6级";
List<OapiAtsResumeAddRequest.EducationInfoDomain> list4 = new List<OapiAtsResumeAddRequest.EducationInfoDomain>();
OapiAtsResumeAddRequest.EducationInfoDomain obj5 = new OapiAtsResumeAddRequest.EducationInfoDomain();
list4.Add(obj5);
obj5.StartDate = "2010-01";
obj5.EndDate = "2010-01";
obj5.School = "浙江大学";
obj5.Speciality = "计算机科学与技术";
obj5.Education = "本科";
obj5.Summary = "专业GPA3.2,一等奖学金";
obj2.EducationInfoList= list4;
List<OapiAtsResumeAddRequest.ExperienceInfoDomain> list7 = new List<OapiAtsResumeAddRequest.ExperienceInfoDomain>();
OapiAtsResumeAddRequest.ExperienceInfoDomain obj8 = new OapiAtsResumeAddRequest.ExperienceInfoDomain();
list7.Add(obj8);
obj8.StartDate = "2010-01";
obj8.EndDate = "2010-01";
obj8.Company = "阿里巴巴";
obj8.Title = "开发工程师";
obj8.Summary = "负责xxx项目的研发工作，取得了xx成果";
obj2.ExperienceInfoList= list7;
List<OapiAtsResumeAddRequest.TrainingInfoDomain> list10 = new List<OapiAtsResumeAddRequest.TrainingInfoDomain>();
OapiAtsResumeAddRequest.TrainingInfoDomain obj11 = new OapiAtsResumeAddRequest.TrainingInfoDomain();
list10.Add(obj11);
obj11.StartDate = "2010-01";
obj11.EndDate = "2010-01";
obj11.TrainingInstitution = "新东方";
obj11.Certificate = "高级厨师证书";
obj11.DescriptionInDetails = "川菜，粤菜，维扬菜，煎炸蒸煮";
obj2.TrainingInfoList= list10;
List<OapiAtsResumeAddRequest.ProjectInfoDomain> list13 = new List<OapiAtsResumeAddRequest.ProjectInfoDomain>();
OapiAtsResumeAddRequest.ProjectInfoDomain obj14 = new OapiAtsResumeAddRequest.ProjectInfoDomain();
list13.Add(obj14);
obj14.StartDate = "2010-01";
obj14.EndDate = "2010-01";
obj14.ProjectName = "xxx项目";
obj14.ProjectDescription = "项目描述";
obj2.ProjectInfoList= list13;
obj1.ResumeDetailInfo= obj2;
obj1.OptUserId = "userId123";
OapiAtsResumeAddRequest.ResumeFileStoreVoDomain obj15 = new OapiAtsResumeAddRequest.ResumeFileStoreVoDomain();
obj15.DownloadUrl = "xxxx";
obj15.FileType = "pdf";
obj15.FileName = "xxx.pdf";
obj1.ResumeFile= obj15;
OapiAtsResumeAddRequest.MailContentDomain obj16 = new OapiAtsResumeAddRequest.MailContentDomain();
obj16.ReceivedTime = "15984483611280";
obj16.MailId = "xxxx";
obj16.FromMailAlias = "xxx";
obj16.MailAddress = "xxxx";
obj16.Title = "xxxx";
obj16.BodyHtml = "xxxxx";
obj16.FromMailAddress = "xxxx";
obj1.OriginMail= obj16;
obj1.VirtualPhoneNumberFlag = true;
obj1.ResumeChannelUrl = "www.alibaba.com";
req.Param_ = obj1;
req.BizCode = "ddats";
OapiAtsResumeAddResponse rsp = client.Execute(req, access_token);
Console.WriteLine(rsp.Body);

include "TopSdk.php";
date_default_timezone_set('Asia/Shanghai');

$c = new DingTalkClient(DingTalkConstant::$CALL_TYPE_OAPI, DingTalkConstant::$METHOD_POST , DingTalkConstant::$FORMAT_JSON);
$req = new OapiAtsResumeAddRequest;
$param = new CollResumeMailParam;
$param->matched_jobs="[xxxx,xxxx,xxxx]";
$param->channel="51job";
$resume_detail_info = new ResumeDetailInfo;
$resume_detail_info->name="张三";
$resume_detail_info->phone_num="18668421234";
$resume_detail_info->email="123@mail.com";
$resume_detail_info->sex="男性";
$resume_detail_info->birth="2010-01";
$resume_detail_info->graduate_time="2010-01";
$resume_detail_info->begin_work_time="2010-01";
$resume_detail_info->nationality="中国";
$resume_detail_info->married="已婚";
$resume_detail_info->native_place="浙江";
$resume_detail_info->now_location="浙江省杭州市";
$resume_detail_info->forward_location="浙江省杭州市";
$resume_detail_info->school="浙江大学";
$resume_detail_info->education="本科";
$resume_detail_info->advanced_degree="理学学士";
$resume_detail_info->student_type="全日制";
$resume_detail_info->school_type="985";
$resume_detail_info->speciality="计算机科学与技术";
$resume_detail_info->salary="1000";
$resume_detail_info->aim_salary="2000";
$resume_detail_info->title_standard="开发工程师";
$resume_detail_info->vocation_standard="互联网";
$resume_detail_info->political="党员";
$resume_detail_info->job_status="求职中";
$resume_detail_info->grade_of_english="6级";
$education_info_list = new EducationInfo;
$education_info_list->start_date="2010-01";
$education_info_list->end_date="2010-01";
$education_info_list->school="浙江大学";
$education_info_list->speciality="计算机科学与技术";
$education_info_list->education="本科";
$education_info_list->summary="专业GPA3.2,一等奖学金";
$resume_detail_info->education_info_list = array($education_info_list);
$experience_info_list = new ExperienceInfo;
$experience_info_list->start_date="2010-01";
$experience_info_list->end_date="2010-01";
$experience_info_list->company="阿里巴巴";
$experience_info_list->title="开发工程师";
$experience_info_list->summary="负责xxx项目的研发工作，取得了xx成果";
$resume_detail_info->experience_info_list = array($experience_info_list);
$training_info_list = new TrainingInfo;
$training_info_list->start_date="2010-01";
$training_info_list->end_date="2010-01";
$training_info_list->training_institution="新东方";
$training_info_list->certificate="高级厨师证书";
$training_info_list->description_in_details="川菜，粤菜，维扬菜，煎炸蒸煮";
$resume_detail_info->training_info_list = array($training_info_list);
$project_info_list = new ProjectInfo;
$project_info_list->start_date="2010-01";
$project_info_list->end_date="2010-01";
$project_info_list->project_name="xxx项目";
$project_info_list->project_description="项目描述";
$resume_detail_info->project_info_list = array($project_info_list);
$param->resume_detail_info = $resume_detail_info;
$param->opt_user_id="userId123";
$resume_file = new ResumeFileStoreVo;
$resume_file->download_url="xxxx";
$resume_file->file_type="pdf";
$resume_file->file_name="xxx.pdf";
$param->resume_file = $resume_file;
$origin_mail = new MailContent;
$origin_mail->received_time="15984483611280";
$origin_mail->mail_id="xxxx";
$origin_mail->from_mail_alias="xxx";
$origin_mail->mail_address="xxxx";
$origin_mail->title="xxxx";
$origin_mail->body_html="xxxxx";
$origin_mail->from_mail_address="xxxx";
$param->origin_mail = $origin_mail;
$param->virtual_phone_number_flag="true";
$param->resume_channel_url="www.alibaba.com";
$req->setParam($param);
$req->setBizCode("ddats");
$resp = $c->execute($req, $access_token, "https://oapi.dingtalk.com/topapi/ats/resume/add");

curl -X POST "https://oapi.dingtalk.com/topapi/ats/resume/add" \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'access_token=7d82516a-6221-4bc0-a642-1b20e311604f' \
-d 'biz_code=ddats' \
-d 'param=null'

# -*- coding: utf-8 -*-
import dingtalk.api

req=dingtalk.api.OapiAtsResumeAddRequest("https://oapi.dingtalk.com/topapi/ats/resume/add")

req.param=""
req.biz_code="ddats"
try:
	resp= req.getResponse(access_token)
	print(resp)
except Exception,e:
	print(e)

pTopRequest pRequest = alloc_top_request();
pTopResponse pResponse = NULL;
pTaobaoClient pClient = alloc_taobao_client(url, appkey, appsecret);
set_api_name(pRequest,"dingtalk.oapi.ats.resume.add");
add_param(pRequest,"param","数据结构JSON示例");
add_param(pRequest,"biz_code","ddats");
pResponse = top_execute(pClient,pRequest,sessionKey);
printf("ret code:%d\n",pResponse->code);
if(pResponse->code == 0){
	pTopResponseIterator ite = init_response_iterator(pResponse);
	pResultItem pResultItem = alloc_result_item();
	while(parseNext(ite, pResultItem) == 0){
		printf("%s:%s\n",pResultItem->key,pResultItem->value);
	}
	destroy_response_iterator(ite);
	destroy_result_item(pResultItem);
}
destroy_top_request(pRequest);
destroy_top_response(pResponse);
destroy_taobao_client(pClient);

TopClient = require('./topClient').TopClient;
var client = new TopClient({
	'appkey': 'appkey',
	'appsecret': 'secret',
	'REST_URL': 'http://gw.api.taobao.com/router/rest'
});

client.execute('dingtalk.oapi.ats.resume.add', {
	'param':'数据结构JSON示例',
	'biz_code':'ddats'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

响应示例

JSON示例

{
    "errmsg":"无访问权限",
    "errcode":400020,
    "result":{
        "resume_id":"abcd1234",
        "pc_jump_url":"xxxx",
        "mobile_jump_url":"xxxx"
    }
}

异常示例

JSON示例

{
	"errcode":88,
	"errmsg":"ding talk error"
}

错误码解释

错误码	错误描述	解决方案

API工具

API测试工具错误码查询工具 SDK下载

如何获得此API

FAQ

我要提问

返回
顶部

开放平台

钉钉API

dingtalk.oapi.ats.resume.add (添加简历信息)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ