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

dingtalk.oapi.smartwork.hrm.master.save (智能人事第三方业务数据写入服务)

提供给isv将外部数据批量写入到钉钉的服务

公共参数

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

请求参数

名称	类型	是否必须	示例值	更多限制	描述
tenant_id	Number	必须	123		业务方id，接入前系统分配
biz_data	Bizdatavo []	必须		最大列表长度：50	业务数据列表
└ userid String 必须 1234567 员工id └ biz_uk String 必须 performance 数据流水唯一标识，如流水号，用以唯一确认一条写入数据 └ biz_time Number 必须 123456 数据变更时间戳，用以保证更新操作的顺序性 scope ScopeVo 必须业务域描述，系统分配，枚举见文档 └ scope_code String 必须 performance 业务域code，如PERFORMANCE，系统分配，枚举见文档 └ version Number 可选 1 业务域版本，接入时系统分配，默认传0 fields Fieldlist [] 必须数据字段列表 └ name String 必须 attitude 字段名 └ value String 必须 a 字段string值，映射规则见文档 └ entityCode String 可选 base 业务域下的细分领域实体

响应参数

名称	类型	示例值	描述
result	IntegrateBatchResultVO		保存结果
fail_result Failresult [] 保存失败的结果，全部保存成功时为空 └ error_msg String 系统错误保存错误信息 └ error_code String 1002 保存错误码 └ success Boolean true 是否成功 └ biz_uk String performance 业务流水唯一标识，和入参一致 └ all_success Boolean true 是否全部保存成功
errmsg	String	系统错误	错误信息
errcode	Number	1002	错误码

请求示例

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

DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/smartwork/hrm/master/save");
OapiSmartworkHrmMasterSaveRequest req = new OapiSmartworkHrmMasterSaveRequest();
req.setTenantId(123L);
List<Bizdatavo> list2 = new ArrayList<Bizdatavo>();
Bizdatavo obj3 = new Bizdatavo();
list2.add(obj3);
obj3.setUserid("1234567");
obj3.setBizUk("performance");
obj3.setBizTime(123456L);
ScopeVo obj5 = new ScopeVo();
obj5.setScopeCode("performance");
obj5.setVersion(1L);
list4.setScope(obj5);
List<Fieldlist> list8 = new ArrayList<Fieldlist>();
Fieldlist obj9 = new Fieldlist();
list8.add(obj9);
obj9.setName("attitude");
obj9.setValue("a");
list6.setFields(list8);
obj3.setEntityCode("base");
req.setBizData(list2);
OapiSmartworkHrmMasterSaveResponse rsp = client.execute(req, access_token);
System.out.println(rsp.getBody());

IDingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/smartwork/hrm/master/save");
OapiSmartworkHrmMasterSaveRequest req = new OapiSmartworkHrmMasterSaveRequest();
req.TenantId = 123L;
List<OapiSmartworkHrmMasterSaveRequest.BizdatavoDomain> list2 = new List<OapiSmartworkHrmMasterSaveRequest.BizdatavoDomain>();
OapiSmartworkHrmMasterSaveRequest.BizdatavoDomain obj3 = new OapiSmartworkHrmMasterSaveRequest.BizdatavoDomain();
list2.Add(obj3);
obj3.Userid = "1234567";
obj3.BizUk = "performance";
obj3.BizTime = 123456L;
OapiSmartworkHrmMasterSaveRequest.ScopeVoDomain obj4 = new OapiSmartworkHrmMasterSaveRequest.ScopeVoDomain();
obj4.ScopeCode = "performance";
obj4.Version = 1L;
obj3.Scope= obj4;
List<OapiSmartworkHrmMasterSaveRequest.FieldlistDomain> list6 = new List<OapiSmartworkHrmMasterSaveRequest.FieldlistDomain>();
OapiSmartworkHrmMasterSaveRequest.FieldlistDomain obj7 = new OapiSmartworkHrmMasterSaveRequest.FieldlistDomain();
list6.Add(obj7);
obj7.Name = "attitude";
obj7.Value = "a";
obj3.Fields= list6;
obj3.EntityCode = "base";
req.BizData_ = list2;
OapiSmartworkHrmMasterSaveResponse 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 OapiSmartworkHrmMasterSaveRequest;
$req->setTenantId("123");
$biz_data = new Bizdatavo;
$biz_data->userid="1234567";
$biz_data->biz_uk="performance";
$biz_data->biz_time="123456";
$scope = new ScopeVo;
$scope->scope_code="performance";
$scope->version="1";
$biz_data->scope = $scope;
$fields = new Fieldlist;
$fields->name="attitude";
$fields->value="a";
$biz_data->fields = array($fields);
$biz_data->entityCode="base";
$req->setBizData(array($biz_data));
$resp = $c->execute($req, $access_token, "https://oapi.dingtalk.com/topapi/smartwork/hrm/master/save");

curl -X POST "https://oapi.dingtalk.com/topapi/smartwork/hrm/master/save" \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'access_token=24910904-1e34-411b-94c5-e95d9cd20916' \
-d 'biz_data=null' \
-d 'tenant_id=123'

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

req=dingtalk.api.OapiSmartworkHrmMasterSaveRequest("https://oapi.dingtalk.com/topapi/smartwork/hrm/master/save")

req.tenant_id=123
req.biz_data=""
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.smartwork.hrm.master.save");
add_param(pRequest,"tenant_id","123");
add_param(pRequest,"biz_data","数据结构JSON示例");
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.smartwork.hrm.master.save', {
	'tenant_id':'123',
	'biz_data':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

响应示例

JSON示例

{
    "result":{
        "fail_result":[
            {
                    "error_msg":"系统错误",
                    "error_code":"1002",
                    "success":true,
                    "biz_uk":"performance"
            }
        ],
        "all_success":true
    },
    "errmsg":"系统错误",
    "errcode":1002
}

异常示例

JSON示例

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

错误码解释

错误码	错误描述	解决方案

API工具

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

如何获得此API

FAQ

我要提问

返回
顶部

开放平台

钉钉API

dingtalk.oapi.smartwork.hrm.master.save (智能人事第三方业务数据写入服务)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ