功能说明：编辑用户
请求方式：POST（HTTPS）multipart/form-data
请求地址：https://qwif.do1.com.cn/qwcgi/api/userAPI/updateUser.do?token=token&corpId=corpId
{
"address":"广州市天河区",
"attribute":"0",
"birthday":"1999-10-12",
"departmentId":"5effccf0f7d3987aea0ca4a698ade9ba",
"email":"daoyi11@qq.com",
"entryTime":"2018-12-12",
"gender":"1",
"identity":"44522419950401432X",
"isLeader":"1",
"listJson":
{
"list":
[
{
"content":"广州员村广园快速路",
"id":"3c0afa85d5e24820af6f78b67c8e4b57",
"optionId":"de6b25ae42194cf1bfa23463fe61428c"
},
{
"content":"多选2",
"optionId":"5ceaa07b1383468ab7bd31c8aa9360d8"
}
]
},
"lunarCalendar":"09-01",
"mark":"备注说明",
"mobile":"13090000000",
"name":"张三",
"nickName":"小明",
"position":"经理",
"qq":"10000",
"remindType":"1",
"sort":"1000",
"tel":"0968-123456",
"tel2":"020-88886666",
"userId":"2370d878a270975ee9a5750bcd498b20",
"userNo":"1302313",
"headPic":"/upload/img/fe63cb089f0646208de2dcde7425aec1/20250811/08779857d0bd2000.jpg",
"mainDepartment":"5effccf0f7d3987aea0ca4a698ade9ba",
"weixinNum":"name12",
"wxUserId":"zhangsan"
}
| 参数 | 说明 | 类型 | 是否必须 | 备注 |
|---|---|---|---|---|
| token | 用于验证 | String | 是 | |
| corpId | 公司唯一标识 | String | 是 | |
| name | 用户名称 | String | 是 | |
| userId | 用户id | String | 是 | |
| departmentId | 部门id | String | 是 | |
| mainDepartment | 主部门id | String | 否 | 默认为departmentId的第一个 |
| headPic | 头像地址 | String | 否 | 传入云平台图片文件的相对路径，参考接口，返回的uri字段 最大10MB，支持JPG,PNG格式 |
| position | 职位 | String | 否 | |
| mobile | 手机号码 | String | 否 | 手机号，微信号，邮箱三者不可同时为空 |
| gender | 性别（1，男；2，女） | String | 否 | 不传默认为1 |
| tel | 座机 | String | 否 | 由纯数字或“-”号组成，最多不超过30个字符 |
| tel2 | 座机2 | String | 否 | 由纯数字或“-”号组成，最多不超过30个字符 |
| 邮箱 | String | 否 | 手机号，微信号，邮箱三者不可同时为空 | |
| QQ号码 | String | 否 | ||
| weixinNum | 微信号 | String | 否 | 手机号，微信号，邮箱三者不可同时为空 |
| wxUserId | 微信用户Id | String | 否 | |
| birthday | 阳历生日 | String | 否 | 格式：yyyy-MM-dd |
| entryTime | 入职时间 | String | 否 | 格式：yyyy-MM-dd |
| attribute | 成员类型 | 整数 | 否 | 0表示普通用户，1表示家长，2表示教师/职工，3表示学生。默认为普通用户 |
| identity | 身份证 | String | 否 | 15位或18位身份证号 |
| nickName | 昵称 | String | 否 | 可在新闻公告应用的生日祝福等场景使用，最多不超过50个字符 |
| sort | 排序 | 整数 | 否 | 按从小到大排序，最大不超过100000000，默认为100000 |
| userNo | 用户编号 | String | 否 | 需要唯一，支持数字、字母，标点符号支持“-”“.”，最多不超过36个字符 |
| isLeader | 身份 | 整数 | 否 | 表示在所在的部门内是否为上级。1表示是，0表示否，默认为否 |
| address | 地址 | String | 否 | 最多不超过200个字符 |
| lunarCalendar | 农历生日 | String | 否 | 例如：09-18表示农历九月十八 |
| remindType | 生日祝福提醒 | String | 否 | 0表示农历，1表示阳历 |
| mark | 备注 | String | 否 | 最多不超过4000个字符 |
| listJson | 自定义字段json | String | 否 | 自定义字段json |
| optionId | 人员自定字段optionId | String | 否 | 自定义字段optionid |
| content | 自定义字需要填入的段值 | String | 否 | 自定义字段值 |
| id | 用户对应自定义字段的主键id | String | 否 | Id（修改自定义时必传，新增某个自定义字段时不传） |
InterfaceUser user = new InterfaceUser();
//用户ID
user.setUserId("6e53cc3431996f5a3bdbcd280f2954fc");
//用户名称
user.setName("张三");
//部门ID
user.setDepartmentId("03263e813a7801d41a7ccff9fc319331");
// 主部门id
user.setMainDepartment("03263e813a7801d41a7ccff9fc319331");
UploadApi uploadApi = QwSdkUtil.getInter(UploadApi.class);
UploadResultVO uploadResultVO = uploadApi.upload(QwSdkUtil.getCacheToken(),
new File("d:/2.jpg"),
null, WxAgentUtil.getAddressBookCode(),false);
// 使用相对路径上传文件，更新头像
user.setHeadPic(uploadResultVO.getUri());
//职位
user.setPosition("经理助理");
//手机号码 手机号，微信号，邮箱三者不可同时为空
user.setMobile("13241214321");
//性别（1，男；2，女）默认为1
user.setGender("1");
//电话
user.setTel("0968-123456");
//邮箱 手机号，微信号，邮箱三者不可同时为空
user.setEmail("daoyiyun543@qq.com");
//QQ号码
user.setQq("10000");
//微信号 手机号，微信号，邮箱三者不可同时为空。已关注的用户不可修改微信号
user.setWeixinNum("name12ss");
//阳历生日
user.setBirthday("1999-10-12");
//入职时间
user.setEntryTime("2018-12-12");
//成员类型
user.setAttribute(0);
//身份证
user.setIdentity("44522419950401432X");
//昵称
user.setNickName("小明");
//排序值
user.setSort(1000);
//用户编号
user.setUserNo("1302313");
//身份
user.setIsLeader(1);
//座机2
user.setTel2("020-88886666");
//地址
user.setAddress("广州市天河区");
//农历生日
user.setLunarCalendar("09-01");
//生日祝福提醒
user.setRemindType("1");
//备注
user.setMark("备注说明");
//设置自定义字段信息
UserListJsonVo userListJsonVo = JSONUtil.stringToObject("{\"list\":[{\"id\":\"3c0afa85d5e24820af6f78b67c8e4b57\",\"optionId\":\"082a0260688f4402967e41de22af4d00\",\"content\":\"广州潭村广园快速路\"},{\"optionId\":\"5ceaa07b1383468ab7bd31c8aa9360d8\",\"content\":\"多选2\"}]}",
UserListJsonVo.class);
user.setListJson(userListJsonVo);
UserApi api = QwSdkUtil.getInter(UserApi.class);
ApiUserResultVO result = api.updateUser(QwSdkUtil.getCacheToken(),user);
System.out.println(JSONUtil.stringify(result));
{
"code":"0",
"data":
{
"user":
{
"address":"广州市天河区",
"attribute":0,
"birthday":"1999-10-12",
"departmentId":"03263e813a7801d41a7ccff9fc319331",
"email":"daoyiyun543@qq.com",
"entryTime":"2018-12-12",
"gender":"1",
"headPic":"0",
"identity":"44522419950401432X",
"isLeader":1,
"listJson":
{
"list":
[
{
"content":"多选2",
"id":"9bdee4e07b9f40f9a1f37c2f965099e6",
"optionId":"5ceaa07b1383468ab7bd31c8aa9360d8",
"orgId":"02f5ca343129495bad85d162d2bd5b34",
"userId":"6e53cc3431996f5a3bdbcd280f2954fc"
},
{
"content":"2019-05-23",
"id":"505be59bbbac46ef88119eee61c32186",
"optionId":"ff5f6ad211cf4ae2a471649205d4ecc0",
"orgId":"02f5ca343129495bad85d162d2bd5b34",
"userId":"6e53cc3431996f5a3bdbcd280f2954fc"
},
{
"content":"广州潭村广园快速路",
"id":"3c0afa85d5e24820af6f78b67c8e4b57",
"optionId":"082a0260688f4402967e41de22af4d00",
"orgId":"02f5ca343129495bad85d162d2bd5b34",
"userId":"6e53cc3431996f5a3bdbcd280f2954fc"
}
]
},
"lunarCalendar":"09-01",
"mark":"备注说明",
"mobile":"13241214321",
"name":"张三",
"nickName":"小明",
"position":"经理助理",
"qq":"10000",
"remindType":"1",
"sort":1000,
"tel":"0968-123456",
"tel2":"020-88886666",
"userId":"6e53cc3431996f5a3bdbcd280f2954fc",
"userNo":"1302313",
"userStatus":"0",
"weixinNum":"name12ss",
"wxUserId":"13241214321"
}
},
"desc":"成功"
}
| 参数 | 说明 |
|---|---|
| userId | 用户ID |
| organId | 组织编号 |
| userStatus | 用户状态 |
| followTime | 关注时间 |
| headPic | 用户头像 |
| name | 用户名称 |
| departmentId | 部门id |
| position | 职位 |
| mobile | 手机号码 |
| gender | 性别（1，男；2，女） |
| tel | 座机 |
| tel2 | 座机2 |
| 邮箱 | |
| QQ号码 | |
| weixinNum | 微信号 |
| wxUserId | 微信用户Id |
| birthday | 阳历生日 |
| entryTime | 入职时间 |
| attribute | 成员类型 |
| identity | 身份证 |
| nickName | 昵称 |
| sort | 排序 |
| userNo | 用户编号 |
| isLeader | 身份 |
| address | 地址 |
| lunarCalendar | 农历生日 |
| remindType | 生日祝福提醒 |
| mark | 备注 |
| listJson | 自定义字段json字符串 |
| list | 自定义字段json集合 |
| id | 唯一ID |
| optionId | 人员自定义字段ID |
| content | 自定义字需要填入的段值 |
| orgId | 机构ID |
| userId | 道一云用户ID |