跳到主要内容

功能说明​

设置当前登录用户的登录账号。只更新账号,不验证或修改密码,不轮换登录会话。

请求说明​

  • 请求类型:POST
  • 请求地址:/jim/users/setaccount
  • Content-Type:application/json
  • 请求头:有效应用的 appkey 和登录返回的 Authorization 原文,不加 Bearer 前缀。
  • 仅允许用户身份:兼容期 legacy 用户 Token 或有效 ds1 用户会话,遵守现有 设备登录策略。拒绝 API Key 和内部 service 凭证,即使服务凭证包含用户 ID 也不允许写入。

请求参数​

参数类型必填说明
accountstring是与注册相同,仅 6–20 位 ASCII 字母或数字,规则为 ^[a-zA-Z0-9]{6,20}$;空白、非 ASCII 字符、标点不允许,不自动裁剪或转小写
passwordstring否当前不使用,不作为密码认证,也不修改密码
{"account":"Zhangsan123"}

账号在应用内唯一,由现有 (app_key, login_account) 唯一索引及数据库不区分大小写的排序规则判定,跨应用可同名。当前用户重复设置相同账号幂等成功;只修改大小写也成功,保存用户输入的大小写。不能用大小写差异占用其他用户已有账号。

响应示例​

{"code":0,"msg":"success","data":null}

错误说明​

code说明
17001缺少 appkey
17002应用不存在
17003请求体或账号参数非法
17005未登录、无效 legacy Token、非用户身份,或严格模式拒绝 legacy
17605ds1 无效或会话已撤销
17012当前应用下的用户不存在
17011同一应用中账号已被其他用户占用,仅账号唯一索引冲突
17000其它数据库错误,不作为账号已占用处理