1. 应用管理员修改用户信息
应用管理员修改用户信息。
请求方式:PUT
请求地址:/bospersonnelservice/{appKey}/users/{key}
1.1. 请求参数:
Headers:
参数名 | 类型 | 示例 | 是否必填 | 参数含义 |
---|---|---|---|---|
Authorization | string | c4570cb9ca324bc8ba7dd9d1967710ea | 是 | access_token |
PathParas:
参数名 | 类型 | 示例 | 是否必填 | 参数含义 |
---|---|---|---|---|
appKey | string | xb05cd3a35614caa85c0f8f86c58fcc1 | 是 | 应用Key |
key | string | key: 需要修改的用户key | 是 | 角色Key |
SearchParas:
参数名 | 类型 | 示例 | 是否必填 | 参数含义 |
---|---|---|---|---|
NULL | NULL | NULL | NULL | NULL |
Body:
application/json:
{
"fullName": "xxx", //姓名
"email": "xxx@xx.com", //邮箱
"telephone": "xxx", //电话号码
"userType": "0", //类型0为普通用户,1为管理员用户,2为代表企业用户,3为内部用户
"xxx": "xxx", //应用库users表中定义的用户扩展属性
"language":"en"//界面中英文类别,目前只支持参数cn和en
}
1.2. 参数说明:
参数名 | 类型 | 示例 | 是否必填 | 参数含义 |
---|---|---|---|---|
fullName | string | NULL | 是 | 姓名 |
string | NULL | 是 | 邮箱 | |
telephone | string | NULL | 是 | 电话号码 |
userType | string | NULL | 是 | 类型0为普通用户,1为管理员用户,2为代表企业用户,3为内部用户" |
1.3. 正确返回:
{
"code": " SUCCESS",
"message": "请求处理成功",
"data": null
}
1.4. 状态码:
状态码 | code | message | data | 原因 |
---|---|---|---|---|
200 | ADMIN_AUTH_ERROR | 没有管理员权限 | NULL | 如果不是应用管理员账户 |
200 | USER_NO_EXIST | 用户不存在 | NULL | 如果用户不存在 |
200 | TELEPHONE_FORMAT_ERROR | 手机号格式错误 | NULL | 如果telephone不是手机号格式 |
200 | TELEPHONE_OCCUPIED | 手机号已被占用 | NULL | 如果telephone已被占用 |
200 | EMAIL_OCCUPIED | 邮箱已被占用 | NULL | 如果输入email,并且email已被占用 |
200 | EMAIL _FORMAT_ERROR | 邮箱格式错误 | NULL | 如果输入email,并且email不是邮箱格式 |
200 | CAN_NOT_UPDATE | 字段name不能被修改 | NULL | 如果输入name |
1.5. 注意事项:
(1) 仅应用管理员有权限调用此接口。
(2) 用户的账号name不能修改,其他属性不为空就修改。
(3) 用户类型目前有4种类型,分别是0为普通用户,1为管理员用户,2为代表企业用户,3为内部用户。
(4) 如果输入email,验证邮箱格式和是否重复。
1.6. 请求示例
请求URL
http://bosgw.bimwinner.com/bospersonnelservice/q85e857aeb0845f19c0dcd2a426e11e0/users/1527ffadaf8a4f4abae985c67bbd496d
Headers
Authorization: eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyS2V5IjoiMTUyN2ZmYWRhZjhhNGY0YWJhZTk4NWM2N2JiZDQ5NmQiLCJ1c2VyTmFtZSI6InJhb2ppYWp1biIsInVzZXJUeXBlIjoiMCIsImFwcEtleSI6InE4NWU4NTdhZWIwODQ1ZjE5YzBkY2QyYTQyNmUxMWUwIiwiYXBwTmFtZSI6InRlc3QxMTExMTEyMyIsImFwcERiIjoicTg1ZTg1N2FlYjA4NDVmMTljMGRjZDJhNDI2ZTExZTAiLCJsb2dpblRpbWUiOiIxNTk3OTk5Mjk3Nzg2IiwiZXhwIjowfQ.MSAOmNa8Q9gfPtKwlpKYcBGAMM6v7JM6OQO-nM113M4
Body(application/json)
{
"fullName": "张三111", //姓名
"email": "12345678@qq.com", //邮箱
"telephone": "12345678910", //电话号码
"userType": "1" //类型0为普通用户,1为管理员用户,2为代表企业用户,3为内部用户
}
正常响应 200
{
"message": "请求处理成功",
"code": "SUCCESS",
"data": null
}