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

dingtalk.oapi.smartwork.hrm.employee.v2.update (智能人事更新员工档案信息)

智能人事更新员工档案信息,支持明细分组

公共参数

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

请求参数

名称	类型	是否必须	示例值	描述
agentid	Number	必须	23470561	微应用在企业的AgentId
param	EmpUpdateByCustomParam	必须		编辑花名册入参
groups EmpGroupFieldVo [] 可选花名册分组 sections EmpListFieldVo [] 可选分组下明细（非明细分组仅一条明细） section EmpFieldVo [] 可选分组下字段列表 └ field_code String 可选 sys01-birthTime 字段标识 └ value String 可选 2020-10-10 字段值 └ old_index Number 可选 0 明细下标（注意：当传入该值时，表示当前传入的section为编辑员工花名册现有的第oldIndex条明细，此时系统会只编辑该条明细中传入的字段；当不传入该值时，表示传入的是新增明细，此时系统会保存该条明细传入的字段，未传字段会清空） └ group_id String 可选 sys01 分组标识 └ userid String 可选 123456 员工userId

响应参数

名称	类型	示例值	描述
result	Boolean	true	调用是否成功
success	Boolean	true	调用结果
errcode	Number	400020	错误码
errmsg	String	无权限访问	错误信息

请求示例

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

DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/smartwork/hrm/employee/v2/update");
OapiSmartworkHrmEmployeeV2UpdateRequest req = new OapiSmartworkHrmEmployeeV2UpdateRequest();
req.setAgentid(23470561L);
EmpUpdateByCustomParam obj1 = new EmpUpdateByCustomParam();
List<EmpGroupFieldVo> list3 = new ArrayList<EmpGroupFieldVo>();
EmpGroupFieldVo obj4 = new EmpGroupFieldVo();
list3.add(obj4);
List<EmpListFieldVo> list7 = new ArrayList<EmpListFieldVo>();
EmpListFieldVo obj8 = new EmpListFieldVo();
list7.add(obj8);
List<EmpFieldVo> list11 = new ArrayList<EmpFieldVo>();
EmpFieldVo obj12 = new EmpFieldVo();
list11.add(obj12);
obj12.setFieldCode("sys01-birthTime");
obj12.setValue("2020-10-10");
list9.setSection(list11);
obj8.setOldIndex(0L);
list5.setSections(list7);
obj4.setGroupId("sys01");
obj1.setGroups(list3);
obj1.setUserid("123456");
req.setParam(obj1);
OapiSmartworkHrmEmployeeV2UpdateResponse rsp = client.execute(req, access_token);
System.out.println(rsp.getBody());

IDingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/smartwork/hrm/employee/v2/update");
OapiSmartworkHrmEmployeeV2UpdateRequest req = new OapiSmartworkHrmEmployeeV2UpdateRequest();
req.Agentid = 23470561L;
OapiSmartworkHrmEmployeeV2UpdateRequest.EmpUpdateByCustomParamDomain obj1 = new OapiSmartworkHrmEmployeeV2UpdateRequest.EmpUpdateByCustomParamDomain();
List<OapiSmartworkHrmEmployeeV2UpdateRequest.EmpGroupFieldVoDomain> list3 = new List<OapiSmartworkHrmEmployeeV2UpdateRequest.EmpGroupFieldVoDomain>();
OapiSmartworkHrmEmployeeV2UpdateRequest.EmpGroupFieldVoDomain obj4 = new OapiSmartworkHrmEmployeeV2UpdateRequest.EmpGroupFieldVoDomain();
list3.Add(obj4);
List<OapiSmartworkHrmEmployeeV2UpdateRequest.EmpListFieldVoDomain> list6 = new List<OapiSmartworkHrmEmployeeV2UpdateRequest.EmpListFieldVoDomain>();
OapiSmartworkHrmEmployeeV2UpdateRequest.EmpListFieldVoDomain obj7 = new OapiSmartworkHrmEmployeeV2UpdateRequest.EmpListFieldVoDomain();
list6.Add(obj7);
List<OapiSmartworkHrmEmployeeV2UpdateRequest.EmpFieldVoDomain> list9 = new List<OapiSmartworkHrmEmployeeV2UpdateRequest.EmpFieldVoDomain>();
OapiSmartworkHrmEmployeeV2UpdateRequest.EmpFieldVoDomain obj10 = new OapiSmartworkHrmEmployeeV2UpdateRequest.EmpFieldVoDomain();
list9.Add(obj10);
obj10.FieldCode = "sys01-birthTime";
obj10.Value = "2020-10-10";
obj7.Section= list9;
obj7.OldIndex = 0L;
obj4.Sections= list6;
obj4.GroupId = "sys01";
obj1.Groups= list3;
obj1.Userid = "123456";
req.Param_ = obj1;
OapiSmartworkHrmEmployeeV2UpdateResponse 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 OapiSmartworkHrmEmployeeV2UpdateRequest;
$req->setAgentid("23470561");
$param = new EmpUpdateByCustomParam;
$groups = new EmpGroupFieldVo;
$sections = new EmpListFieldVo;
$section = new EmpFieldVo;
$section->field_code="sys01-birthTime";
$section->value="2020-10-10";
$sections->section = array($section);
$sections->old_index="0";
$groups->sections = array($sections);
$groups->group_id="sys01";
$param->groups = array($groups);
$param->userid="123456";
$req->setParam($param);
$resp = $c->execute($req, $access_token, "https://oapi.dingtalk.com/topapi/smartwork/hrm/employee/v2/update");

curl -X POST "https://oapi.dingtalk.com/topapi/smartwork/hrm/employee/v2/update" \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'access_token=3d8dbb51-55d7-47ce-9cff-18977400e967' \
-d 'agentid=23470561' \
-d 'param=null'

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

req=dingtalk.api.OapiSmartworkHrmEmployeeV2UpdateRequest("https://oapi.dingtalk.com/topapi/smartwork/hrm/employee/v2/update")

req.agentid=23470561
req.param=""
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.employee.v2.update");
add_param(pRequest,"agentid","23470561");
add_param(pRequest,"param","数据结构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.employee.v2.update', {
	'agentid':'23470561',
	'param':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

响应示例

JSON示例

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

异常示例

JSON示例

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

错误码解释

错误码	错误描述	解决方案

API工具

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

如何获得此API

FAQ

我要提问

返回
顶部

开放平台

钉钉API

dingtalk.oapi.smartwork.hrm.employee.v2.update (智能人事更新员工档案信息)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ