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

dingtalk.oapi.smartwork.hrm.employee.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。

请求参数

名称	类型	是否必须	示例值	描述
param	PreEntryEmployeeAddParam	必须		添加待入职入参
└ userid String 可选 manager781 staff_id or userId用户在企业的唯一标识 groups GroupMetaInfo [] 可选所有组明细 └ group_id String 可选 sys01 需改的字段所在组ID sections EmpListFieldVO [] 可选同类型组明细 section EmpFieldVo [] 可选单个组所有字段 └ value String 可选 123123 更新的字段值 └ field_code String 可选 sys01-dept 更新的字段code
agentid	Number	必须	23470561	微应用在企业的AgentId

响应参数

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

请求示例

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

DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/smartwork/hrm/employee/update");
OapiSmartworkHrmEmployeeUpdateRequest req = new OapiSmartworkHrmEmployeeUpdateRequest();
PreEntryEmployeeAddParam obj1 = new PreEntryEmployeeAddParam();
obj1.setUserid("manager781");
List<GroupMetaInfo> list3 = new ArrayList<GroupMetaInfo>();
GroupMetaInfo obj4 = new GroupMetaInfo();
list3.add(obj4);
obj4.setGroupId("sys01");
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.setValue("123123");
obj12.setFieldCode("sys01-dept");
list9.setSection(list11);
list5.setSections(list7);
obj1.setGroups(list3);
req.setParam(obj1);
req.setAgentid(23470561L);
OapiSmartworkHrmEmployeeUpdateResponse rsp = client.execute(req, access_token);
System.out.println(rsp.getBody());

IDingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/smartwork/hrm/employee/update");
OapiSmartworkHrmEmployeeUpdateRequest req = new OapiSmartworkHrmEmployeeUpdateRequest();
OapiSmartworkHrmEmployeeUpdateRequest.PreEntryEmployeeAddParamDomain obj1 = new OapiSmartworkHrmEmployeeUpdateRequest.PreEntryEmployeeAddParamDomain();
obj1.Userid = "manager781";
List<OapiSmartworkHrmEmployeeUpdateRequest.GroupMetaInfoDomain> list3 = new List<OapiSmartworkHrmEmployeeUpdateRequest.GroupMetaInfoDomain>();
OapiSmartworkHrmEmployeeUpdateRequest.GroupMetaInfoDomain obj4 = new OapiSmartworkHrmEmployeeUpdateRequest.GroupMetaInfoDomain();
list3.Add(obj4);
obj4.GroupId = "sys01";
List<OapiSmartworkHrmEmployeeUpdateRequest.EmpListFieldVODomain> list6 = new List<OapiSmartworkHrmEmployeeUpdateRequest.EmpListFieldVODomain>();
OapiSmartworkHrmEmployeeUpdateRequest.EmpListFieldVODomain obj7 = new OapiSmartworkHrmEmployeeUpdateRequest.EmpListFieldVODomain();
list6.Add(obj7);
List<OapiSmartworkHrmEmployeeUpdateRequest.EmpFieldVoDomain> list9 = new List<OapiSmartworkHrmEmployeeUpdateRequest.EmpFieldVoDomain>();
OapiSmartworkHrmEmployeeUpdateRequest.EmpFieldVoDomain obj10 = new OapiSmartworkHrmEmployeeUpdateRequest.EmpFieldVoDomain();
list9.Add(obj10);
obj10.Value = "123123";
obj10.FieldCode = "sys01-dept";
obj7.Section= list9;
obj4.Sections= list6;
obj1.Groups= list3;
req.Param_ = obj1;
req.Agentid = 23470561L;
OapiSmartworkHrmEmployeeUpdateResponse 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 OapiSmartworkHrmEmployeeUpdateRequest;
$param = new PreEntryEmployeeAddParam;
$param->userid="manager781";
$groups = new GroupMetaInfo;
$groups->group_id="sys01";
$sections = new EmpListFieldVO;
$section = new EmpFieldVo;
$section->value="123123";
$section->field_code="sys01-dept";
$sections->section = array($section);
$groups->sections = array($sections);
$param->groups = array($groups);
$req->setParam($param);
$req->setAgentid("23470561");
$resp = $c->execute($req, $access_token, "https://oapi.dingtalk.com/topapi/smartwork/hrm/employee/update");

curl -X POST "https://oapi.dingtalk.com/topapi/smartwork/hrm/employee/update" \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'access_token=1a839ef0-bfb8-4ba4-9804-b05fdc7bae1e' \
-d 'agentid=23470561' \
-d 'param=null'

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

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

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

响应示例

JSON示例

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

异常示例

JSON示例

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

错误码解释

错误码	错误描述	解决方案

API工具

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

如何获得此API

FAQ

我要提问

返回
顶部

淘宝开放平台

钉钉API

dingtalk.oapi.smartwork.hrm.employee.update (更新员工花名册)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ