更新用户信息
POST
/user/update说明
调用本接口更新用户详情。
服务地址:https://oapi.dingtalk.com
权限
服务端API是以应用维度授权的,在调用接口前,确保已经为应用添加了接口权限。详情请参考权限申请。
应用类型 | 是否支持调用 | 权限申请方式 | API Explorer调试 |
---|---|---|---|
企业内部应用 | 是 | 开发者后台申请 | 调试 |
第三方企业应用 | 否 | — | — |
第三方个人应用 | 否 | — | — |
请求参数
调用服务端API授权凭证,可通过获取企业内部应用的access_token接口获取。
员工userid,不可修改,长度为1~64个字符,可通过根据手机号获取userid接口获取。
员工姓名,长度为1~64个字符。
员工直属主管的userid
办公地点,长度为0~50个字符。
备注,长度为0~1000个字符。
是否开启高管模式:true:开启开启后,手机号码对所有员工隐藏。普通员工无法对其发DING、发起钉钉免费商务电话。高管之间不受影响。false:不开启
分机号,长度为0~50个字符。
在对应的部门中的排序,Map结构的json字符串。Key是部门的ID,Value是人员在这个部门的排序值。
成员所属部门ID列表。
员工邮箱。长度为0~64个字符。企业内必须唯一,不可重复。
职位信息。长度为0~64个字符。
设置用户在每个部门下的职位。Key是deptId,表示部门ID;Value是职位,表示在这个部门下的职位。
扩展属性。手机上最多只能显示10个扩展属性,可登录OA管理后台>设置>通讯录信息进行设置。查看扩展属性:链接类型扩展属性,只支持在“移动端钉钉-点击该用户头像-个人资料页”查看,点击链接可以跳转。链接类型支持变量通配符自动替换,目前支持通配符有:userid,corpid。例如: 工位地址。非链接类型扩展属性,支持在“移动端钉钉/PC端钉钉-点击该用户头像-个人资料页”查看
员工工号,对应显示到OA后台和客户端个人资料的工号栏目。长度为0~64个字符。
是否号码隐藏:true:隐藏隐藏手机号后,手机号在个人资料页隐藏,但仍可对其发DING、发起钉钉免费商务电话。false:不隐藏
通讯录语言,默认zh_CN。如果是英文,请输入en_US。
入职时间,Unix时间戳。
{
"orderInDepts": "{\"1995\":\"1\"}",
"isSenior": "true",
"hiredDate": 1599735213000,
"name": "测试回调",
"extattr": "{\"爱好\":\"读书\"}",
"positionInDepts": "{\"1995\":\"技术支持\"}",
"remark": "测试用户",
"tel": "8646xxxx",
"position": "技术支持",
"department": [
1995
],
"userid": "2022",
"managerUserid": "user01"
}
示例代码
返回响应
{
"errcode": 0,
"errmsg": "string"
}