功能说明
设置当前登录用户的登录账号。只更新账号,不验证或修改密码,不轮换登录会话。
请求说明
- 请求类型:
POST - 请求地址:
/jim/users/setaccount - Content-Type:
application/json - 请求头:有效应用的
appkey和登录返回的Authorization原文,不加 Bearer 前缀。 - 仅允许用户身份:兼容期 legacy 用户 Token 或有效
ds1用户会话,遵守现有 设备登录策略。拒绝 API Key 和内部 service 凭证,即使服务凭证包含用户 ID 也不允许写入。
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| account | string | 是 | 与注册相同,仅 6–20 位 ASCII 字母或数字,规则为 ^[a-zA-Z0-9]{6,20}$;空白、非 ASCII 字符、标点不允许,不自动裁剪或转小写 |
| password | string | 否 | 当前不使用,不作为密码认证,也不修改密码 |
{"account":"Zhangsan123"}
账号在应用内唯一,由现有 (app_key, login_account) 唯一索引及数据库不区分大小写的排序规则判定,跨应用可同名。当前用户重复设置相同账号幂等成功;只修改大小写也成功,保存用户输入的大小写。不能用大小写差异占用其他用户已有账号。
响应示例
{"code":0,"msg":"success","data":null}
错误说明
| code | 说明 |
|---|---|
| 17001 | 缺少 appkey |
| 17002 | 应用不存在 |
| 17003 | 请求体或账号参数非法 |
| 17005 | 未登录、无效 legacy Token、非用户身份,或严格模式拒绝 legacy |
| 17605 | ds1 无效或会话已撤销 |
| 17012 | 当前应用下的用户不存在 |
| 17011 | 同一应用中账号已被其他用户占用,仅账号唯一索引冲突 |
| 17000 | 其它数据库错误,不作为账号已占用处理 |