dingtalk.oapi.user.update (更新用户详情)

更新用户详情

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
userid String 可选 1 用户id
name String 可选 1 名字
workPlace String 可选 1 工作地点
remark String 可选 1 备注
isSenior Boolean 可选 true 是否高管模式
orgEmail String 可选 1 公司邮箱
managerUserid String 可选 1 主管
tel String 可选 1 分机号,长度为0~50个字符
orderInDepts String 可选 1 实际是Map的序列化字符串
mobile String 可选 1 手机号
department Number [] 可选 1
  • 最大列表长度:20
  • 部门列表
    email String 可选 1 邮箱
    position String 可选 1 职位
    extattr String 可选 1 扩展属性
    jobnumber String 可选 1 工号
    isHide Boolean 可选 true 是否号码隐藏
    lang String 可选 1 通讯录语言(默认zh_CN另外支持en_US)
    hiredDate Number 可选 1 入职时间
    positionInDepts String 可选 1 实际是Map的序列化字符串

    响应参数

    名称 类型 示例值 描述
    errcode Number 0 errcode
    errmsg String ok errmsg

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/user/update");
    OapiUserUpdateRequest req = new OapiUserUpdateRequest();
    req.setUserid("1");
    req.setName("1");
    req.setWorkPlace("1");
    req.setRemark("1");
    req.setIsSenior(true);
    req.setOrgEmail("1");
    req.setManagerUserid("1");
    req.setTel("1");
    req.setOrderInDepts("1");
    req.setMobile("1");
    req.setDepartment("1");
    req.setEmail("1");
    req.setPosition("1");
    req.setExtattr("1");
    req.setJobnumber("1");
    req.setIsHide(true);
    req.setLang("1");
    req.setHiredDate(1L);
    req.setPositionInDepts("1");
    OapiUserUpdateResponse rsp = client.execute(req, access_token);
    System.out.println(rsp.getBody());

    响应示例

    • JSON示例
    {
        "errcode":0,
        "errmsg":"ok"
    }

    异常示例

    • JSON示例
    {
    	"error_response":{
    		"msg":"Remote service error",
    		"code":50,
    		"sub_msg":"非法参数",
    		"sub_code":"isv.invalid-parameter"
    	}
    }

    错误码解释

    错误码 错误描述 解决方案

    API工具

    如何获得此API

    FAQ

    返回
    顶部