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

dingtalk.oapi.ats.rpa.resume.mail.collect (获取招聘平台简历文件邮件回传信息)

招聘平台，简历文件回流信息

公共参数

环境	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	必须		简历文件参数
origin_mail MailContent 可选原始邮件信息，可选 └ from_mail_address String 可选 xxxx 发件人邮件地址，可选 └ body_html String 可选 xxxx 邮件正文，可选 └ title String 可选 xxxx 邮件标题，可选 └ mail_address String 可选 xxxx 邮件地址，可选 └ from_mail_alias String 可选 xxxx 发件人姓名 └ mail_id String 可选 xxxx 邮件id └ received_time Number 可选 15984483611280 收件时间，时间戳毫秒 resume_file ResumeFileStoreVo 可选简历文件信息 └ download_url String 可选 xxxxx 下载地址 └ file_type String 可选 pdf 文件类型 └ file_name String 可选 xxx.pdf 文件名，需要带后缀 └ channel String 必须 51job 渠道来源，接入前请提前沟通 └ matched_jobs String [] 可选 [xxxx,xxxx,xxxx] 匹配到的职位列表 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 可选操作人userId userId123
biz_code	String	必须	ddats	业务唯一标识，接入前请提前沟通

响应参数

名称	类型	示例值	描述
errmsg	String	无访问权限	错误信息
errcode	Number	400020	错误码
result	Boolean	true	处理结果

请求示例

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

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

IDingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/ats/rpa/resume/mail/collect");
OapiAtsRpaResumeMailCollectRequest req = new OapiAtsRpaResumeMailCollectRequest();
OapiAtsRpaResumeMailCollectRequest.CollResumeMailParamDomain obj1 = new OapiAtsRpaResumeMailCollectRequest.CollResumeMailParamDomain();
OapiAtsRpaResumeMailCollectRequest.MailContentDomain obj2 = new OapiAtsRpaResumeMailCollectRequest.MailContentDomain();
obj2.FromMailAddress = "xxxx";
obj2.BodyHtml = "xxxx";
obj2.Title = "xxxx";
obj2.MailAddress = "xxxx";
obj2.FromMailAlias = "xxxx";
obj2.MailId = "xxxx";
obj2.ReceivedTime = 15984483611280L;
obj1.OriginMail= obj2;
OapiAtsRpaResumeMailCollectRequest.ResumeFileStoreVoDomain obj3 = new OapiAtsRpaResumeMailCollectRequest.ResumeFileStoreVoDomain();
obj3.DownloadUrl = "xxxxx";
obj3.FileType = "pdf";
obj3.FileName = "xxx.pdf";
obj1.ResumeFile= obj3;
obj1.Channel = "51job";
obj1.MatchedJobs = "xxxx,xxxx,xxxx";
OapiAtsRpaResumeMailCollectRequest.ResumeDetailInfoDomain obj4 = new OapiAtsRpaResumeMailCollectRequest.ResumeDetailInfoDomain();
obj4.Name = "张三";
obj4.PhoneNum = "18668421234";
obj4.Email = "123@mail.com";
obj4.Sex = "男性";
obj4.Birth = "2010-01";
obj4.GraduateTime = "2010-01";
obj4.BeginWorkTime = "2010-01";
obj4.Nationality = "中国";
obj4.Married = "已婚";
obj4.NativePlace = "浙江";
obj4.NowLocation = "浙江省杭州市";
obj4.ForwardLocation = "浙江省杭州市";
obj4.School = "浙江大学";
obj4.Education = "本科";
obj4.AdvancedDegree = "理学学士";
obj4.StudentType = "全日制";
obj4.SchoolType = "985";
obj4.Speciality = "计算机科学与技术";
obj4.Salary = "1000";
obj4.AimSalary = "2000";
obj4.TitleStandard = "开发工程师";
obj4.VocationStandard = "互联网";
obj4.Political = "党员";
obj4.JobStatus = "求职中";
obj4.GradeOfEnglish = "6级";
List<OapiAtsRpaResumeMailCollectRequest.EducationInfoDomain> list6 = new List<OapiAtsRpaResumeMailCollectRequest.EducationInfoDomain>();
OapiAtsRpaResumeMailCollectRequest.EducationInfoDomain obj7 = new OapiAtsRpaResumeMailCollectRequest.EducationInfoDomain();
list6.Add(obj7);
obj7.StartDate = "2010-01";
obj7.EndDate = "2010-01";
obj7.School = "浙江大学";
obj7.Speciality = "计算机科学与技术";
obj7.Education = "本科";
obj7.Summary = "专业GPA3.2,一等奖学金";
obj4.EducationInfoList= list6;
List<OapiAtsRpaResumeMailCollectRequest.ExperienceInfoDomain> list9 = new List<OapiAtsRpaResumeMailCollectRequest.ExperienceInfoDomain>();
OapiAtsRpaResumeMailCollectRequest.ExperienceInfoDomain obj10 = new OapiAtsRpaResumeMailCollectRequest.ExperienceInfoDomain();
list9.Add(obj10);
obj10.StartDate = "2010-01";
obj10.EndDate = "2010-01";
obj10.Company = "阿里巴巴";
obj10.Title = "开发工程师";
obj10.Summary = "负责xxx项目的研发工作，取得了xx成果";
obj4.ExperienceInfoList= list9;
List<OapiAtsRpaResumeMailCollectRequest.TrainingInfoDomain> list12 = new List<OapiAtsRpaResumeMailCollectRequest.TrainingInfoDomain>();
OapiAtsRpaResumeMailCollectRequest.TrainingInfoDomain obj13 = new OapiAtsRpaResumeMailCollectRequest.TrainingInfoDomain();
list12.Add(obj13);
obj13.StartDate = "2010-01";
obj13.EndDate = "2010-01";
obj13.TrainingInstitution = "新东方";
obj13.Certificate = "高级厨师证书";
obj13.DescriptionInDetails = "川菜，粤菜，维扬菜，煎炸蒸煮";
obj4.TrainingInfoList= list12;
List<OapiAtsRpaResumeMailCollectRequest.ProjectInfoDomain> list15 = new List<OapiAtsRpaResumeMailCollectRequest.ProjectInfoDomain>();
OapiAtsRpaResumeMailCollectRequest.ProjectInfoDomain obj16 = new OapiAtsRpaResumeMailCollectRequest.ProjectInfoDomain();
list15.Add(obj16);
obj16.StartDate = "2010-01";
obj16.EndDate = "2010-01";
obj16.ProjectName = "xxx项目";
obj16.ProjectDescription = "项目描述";
obj4.ProjectInfoList= list15;
obj1.ResumeDetailInfo= obj4;
obj1.OptUserId = "操作人userId";
req.Param_ = obj1;
req.BizCode = "ddats";
OapiAtsRpaResumeMailCollectResponse 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 OapiAtsRpaResumeMailCollectRequest;
$param = new CollResumeMailParam;
$origin_mail = new MailContent;
$origin_mail->from_mail_address="xxxx";
$origin_mail->body_html="xxxx";
$origin_mail->title="xxxx";
$origin_mail->mail_address="xxxx";
$origin_mail->from_mail_alias="xxxx";
$origin_mail->mail_id="xxxx";
$origin_mail->received_time="15984483611280";
$param->origin_mail = $origin_mail;
$resume_file = new ResumeFileStoreVo;
$resume_file->download_url="xxxxx";
$resume_file->file_type="pdf";
$resume_file->file_name="xxx.pdf";
$param->resume_file = $resume_file;
$param->channel="51job";
$param->matched_jobs="[xxxx,xxxx,xxxx]";
$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="操作人userId";
$req->setParam($param);
$req->setBizCode("ddats");
$resp = $c->execute($req, $access_token, "https://oapi.dingtalk.com/topapi/ats/rpa/resume/mail/collect");

curl -X POST "https://oapi.dingtalk.com/topapi/ats/rpa/resume/mail/collect" \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'access_token=b40052c7-2d38-4419-a830-4d434856ba8f' \
-d 'biz_code=ddats' \
-d 'param=null'

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

req=dingtalk.api.OapiAtsRpaResumeMailCollectRequest("https://oapi.dingtalk.com/topapi/ats/rpa/resume/mail/collect")

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.rpa.resume.mail.collect");
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.rpa.resume.mail.collect', {
	'param':'数据结构JSON示例',
	'biz_code':'ddats'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

响应示例

JSON示例

{
    "errmsg":"无访问权限",
    "errcode":400020,
    "result":true
}

异常示例

JSON示例

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

错误码解释

错误码	错误描述	解决方案

API工具

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

如何获得此API

FAQ

我要提问

返回
顶部

开放平台

钉钉API

dingtalk.oapi.ats.rpa.resume.mail.collect (获取招聘平台简历文件邮件回传信息)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ