更新用户信息
POST
/topapi/v2/user/update说明
调用本接口更新指定的用户信息。
服务地址:https://oapi.dingtalk.com
权限
服务端API是以应用维度授权的,在调用接口前,确保已经为应用添加了接口权限。详情请参考权限申请。
应用类型 | 是否支持调用 | 权限申请方式 | API Explorer调试 |
---|---|---|---|
企业内部应用 | 是 | 开发者后台申请 | 调试 |
第三方企业应用 | 否 | — | — |
第三方个人应用 | 否 | — | — |
请求参数
调用服务端API授权凭证,可通过获取企业内部应用的access_token接口获取。
员工的userid。
员工名称,长度最大80个字符。
是否号码隐藏:true:隐藏隐藏手机号后,手机号在个人资料页隐藏,但仍可对其发DING、发起钉钉免费商务电话。false:不隐藏
分机号,长度最大50个字符。企业内必须唯一,不可重复
员工工号,长度最大50个字符。
直属主管的userId。
职位,长度最大200个字符。
员工邮箱,长度最大50个字符。企业内必须唯一,不可重复。
员工的企业邮箱。员工的企业邮箱已开通,才能增加此字段。
员工的企业邮箱类型,仅对支持的组织生效(profession: 标准版,base: 基础版)。
办公地点,长度最大100个字符。
备注,长度最大2000个字符。
员工在对应的部门中的排序。
员工在部门中的排序。
员工在对应的部门中的职位。
员工在部门中的职位。
扩展属性,长度最大2000个字符。可以设置多种属性(手机上最多显示10个扩展属性,具体显示哪些属性,可登录OA管理后台>设置>通讯录信息进行设置。该字段的值支持链接类型填写,同时链接支持变量通配符自动替换,目前支持通配符有:userid和corpid。示例: 工位地址。
是否开启高管模式:true:开启。开启后,手机号码对所有员工隐藏。普通员工无法对其发DING、发起钉钉免费商务电话。高管之间不受影响。false:不开启。
入职时间,UNIX时间戳,单位毫秒。
通讯录语言,默认zh_CN。如果是英文,请传入en_US。
强制更新的字段,支持清空指定的字段,多个字段之间使用逗号分隔。目前支持字段: manager_userid。
{
"extension": {
"爱好": "旅游",
"年龄": "24"
},
"mobile": "1851302xxxx",
"telephone": "010-86123456-2345",
"remark": "备注备注",
"language": "zh_CN",
"hide_mobile": "false",
"title": "技术总监",
"hired_date": "1597573616828",
"userid": "zhangsan",
"work_place": "未来park",
"dept_title_list": {
"dept_id": "2",
"title": "资深产品经理"
},
"dept_order_list": {
"dept_id": "2",
"order": "1"
},
"senior_mode": "false",
"org_email": "test@xxx.com",
"name": "张三",
"dept_id_list": "2,3,4",
"job_number": "4",
"email": "test@xxx.com"
}
示例代码
返回响应
返回码,0代表成功。
调用失败时返回的错误信息。
{
"errcode": 0,
"errmsg": "string"
}