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

dingtalk.oapi.ats.job.batchadd (批量添加职位)

批量添加职位

公共参数

环境	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。

请求参数

名称	类型	是否必须	示例值	更多限制	描述
biz_code	String	必须	ddats		招聘业务标识
jobs	AtsAddJobParam []	必须		最大列表长度：999	职位列表，单次最多20个
└ district String 可选 330102 区县编码 └ city String 可选 330100 城市编码 └ province String 可选 330000 省域编码 └ job_nature String 可选 FULL-TIME 默认值：FULL-TIME 职位性质，FULL-TIME：全职，PART-TIME：兼职，INTERNSHIP：实习，OTHER：其他 ext_data JobExtDataVo 必须扩展数据 full_time_ext_data JobFullTimeExtDataVo 可选全职扩展数据 └ salary_month Number 可选 12 默认值：12 薪资发放月数 └ head_count Number 必须 1 招募人数 └ channel String 可选 liepin 职位来源渠道 └ creator_user_id String 必须 xxx 操作人员工标识 address JobAddressVo 可选工作地点 └ detail String 必须阿里巴巴西溪园区位置详情 └ name String 可选杭州位置名称 └ max_salary Number 必须 1000 最低月薪，单位：元 └ min_salary Number 必须 5000 最高月薪，单位：元 └ required_edu Number 必须 6 学历要求，1小学 2初中 3高中 4中专 5大专 6本科 7硕士 8 博士 9其他 └ campus Boolean 必须 false 是否校招 └ description String 必须 xxx 职位描述 └ name String 必须开发工程师职位名称 └ owner_user_ids String [] 可选 ["xxx","yyy","zzz"] 职位负责人的员工标识列表
op_user_id	String	必须	xxx		操作人员工标识

响应参数

名称	类型	示例值	描述
result	DingOpenResult	无	返回结果
result BatchResultVo 无批量操作结果 result BatchResultItemVO [] 无操作结果项列表 └ error_msg String 参数错误错误描述 └ error_code String ATS1002 错误码 item JobSimpleVo 无职位 └ name String 开发工程师职位名称 └ job_code String J666888 职位编号 └ job_id String jobIdabcdefg 职位唯一标识 └ success Boolean true 是否成功 └ index Number 0 下标（从0开始） └ failed_count Number 0 失败数量 └ success_count Number 1 成功数量 └ total_count Number 1 总数量 └ errmsg String xxx 错误描述 └ errcode Number 0 错误码

请求示例

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

DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/ats/job/batchadd");
OapiAtsJobBatchaddRequest req = new OapiAtsJobBatchaddRequest();
req.setBizCode("ddats");
List<AtsAddJobParam> list2 = new ArrayList<AtsAddJobParam>();
AtsAddJobParam obj3 = new AtsAddJobParam();
list2.add(obj3);
obj3.setDistrict("330102");
obj3.setCity("330100");
obj3.setProvince("330000");
obj3.setJobNature("FULL-TIME");
JobExtDataVo obj5 = new JobExtDataVo();
JobFullTimeExtDataVo obj6 = new JobFullTimeExtDataVo();
obj6.setSalaryMonth(12L);
obj5.setFullTimeExtData(obj6);
obj5.setHeadCount(1L);
obj5.setChannel("liepin");
list4.setExtData(obj5);
obj3.setCreatorUserId("xxx");
JobAddressVo obj8 = new JobAddressVo();
obj8.setDetail("阿里巴巴西溪园区");
obj8.setName("杭州");
list7.setAddress(obj8);
obj3.setMaxSalary(1000L);
obj3.setMinSalary(5000L);
obj3.setRequiredEdu(6L);
obj3.setCampus(false);
obj3.setDescription("xxx");
obj3.setName("开发工程师");
obj3.setOwnerUserIds(""xxx","yyy","zzz"");
req.setJobs(list2);
req.setOpUserId("xxx");
OapiAtsJobBatchaddResponse rsp = client.execute(req, access_token);
System.out.println(rsp.getBody());

IDingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/ats/job/batchadd");
OapiAtsJobBatchaddRequest req = new OapiAtsJobBatchaddRequest();
req.BizCode = "ddats";
List<OapiAtsJobBatchaddRequest.AtsAddJobParamDomain> list2 = new List<OapiAtsJobBatchaddRequest.AtsAddJobParamDomain>();
OapiAtsJobBatchaddRequest.AtsAddJobParamDomain obj3 = new OapiAtsJobBatchaddRequest.AtsAddJobParamDomain();
list2.Add(obj3);
obj3.District = "330102";
obj3.City = "330100";
obj3.Province = "330000";
obj3.JobNature = "FULL-TIME";
OapiAtsJobBatchaddRequest.JobExtDataVoDomain obj4 = new OapiAtsJobBatchaddRequest.JobExtDataVoDomain();
OapiAtsJobBatchaddRequest.JobFullTimeExtDataVoDomain obj5 = new OapiAtsJobBatchaddRequest.JobFullTimeExtDataVoDomain();
obj5.SalaryMonth = 12L;
obj4.FullTimeExtData= obj5;
obj4.HeadCount = 1L;
obj4.Channel = "liepin";
obj3.ExtData= obj4;
obj3.CreatorUserId = "xxx";
OapiAtsJobBatchaddRequest.JobAddressVoDomain obj6 = new OapiAtsJobBatchaddRequest.JobAddressVoDomain();
obj6.Detail = "阿里巴巴西溪园区";
obj6.Name = "杭州";
obj3.Address= obj6;
obj3.MaxSalary = 1000L;
obj3.MinSalary = 5000L;
obj3.RequiredEdu = 6L;
obj3.Campus = false;
obj3.Description = "xxx";
obj3.Name = "开发工程师";
obj3.OwnerUserIds = ""xxx","yyy","zzz"";
req.Jobs_ = list2;
req.OpUserId = "xxx";
OapiAtsJobBatchaddResponse 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 OapiAtsJobBatchaddRequest;
$req->setBizCode("ddats");
$jobs = new AtsAddJobParam;
$jobs->district="330102";
$jobs->city="330100";
$jobs->province="330000";
$jobs->job_nature="FULL-TIME";
$ext_data = new JobExtDataVo;
$full_time_ext_data = new JobFullTimeExtDataVo;
$full_time_ext_data->salary_month="12";
$ext_data->full_time_ext_data = $full_time_ext_data;
$ext_data->head_count="1";
$ext_data->channel="liepin";
$jobs->ext_data = $ext_data;
$jobs->creator_user_id="xxx";
$address = new JobAddressVo;
$address->detail="阿里巴巴西溪园区";
$address->name="杭州";
$jobs->address = $address;
$jobs->max_salary="1000";
$jobs->min_salary="5000";
$jobs->required_edu="6";
$jobs->campus="false";
$jobs->description="xxx";
$jobs->name="开发工程师";
$jobs->owner_user_ids="[\"xxx\",\"yyy\",\"zzz\"]";
$req->setJobs(array($jobs));
$req->setOpUserId("xxx");
$resp = $c->execute($req, $access_token, "https://oapi.dingtalk.com/topapi/ats/job/batchadd");

curl -X POST "https://oapi.dingtalk.com/topapi/ats/job/batchadd" \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'access_token=d0923ede-89a0-4e43-bfca-0b15eaa39c47' \
-d 'biz_code=ddats' \
-d 'jobs=null' \
-d 'op_user_id=xxx'

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

req=dingtalk.api.OapiAtsJobBatchaddRequest("https://oapi.dingtalk.com/topapi/ats/job/batchadd")

req.biz_code="ddats"
req.jobs=""
req.op_user_id="xxx"
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.job.batchadd");
add_param(pRequest,"biz_code","ddats");
add_param(pRequest,"jobs","数据结构JSON示例");
add_param(pRequest,"op_user_id","xxx");
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.job.batchadd', {
	'biz_code':'ddats',
	'jobs':'数据结构JSON示例',
	'op_user_id':'xxx'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

响应示例

JSON示例

{
    "result":{
        "result":{
            "result":[
                {
                        "error_msg":"参数错误",
                        "error_code":"ATS1002",
                        "item":{
                            "name":"开发工程师",
                            "job_code":"J666888",
                            "job_id":"jobIdabcdefg"
                        },
                        "success":true,
                        "index":0
                }
            ],
            "failed_count":0,
            "success_count":1,
            "total_count":1
        },
        "errmsg":"xxx",
        "errcode":0
    }
}

异常示例

JSON示例

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

错误码解释

错误码	错误描述	解决方案

API工具

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

如何获得此API

FAQ

我要提问

返回
顶部

用户反馈

亲，您还没填写反馈内容。

联系方式

亲，电话号码格式不正确。

验证码刷新
亲，验证码错啦！

提交反馈

用户反馈

感谢您的反馈！

用户反馈

网络异常，请重新提交！
重新提交

钉钉API

dingtalk.oapi.ats.job.batchadd (批量添加职位)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ

用户导航

用户反馈

用户反馈

用户反馈