跳到主要内容

功能说明​

进入密码界面时调用独立轻量接口,以当前数据库状态决定展示“首次设置”还是“修改密码”。不需要读取完整用户信息或复用用户资料缓存,不返回手机号、密码或 hash。

本文描述当前服务端源码,不代表接口已部署。can_set_password_by_sms 只表示资格,实际发送及提交见 短信首次设置密码,不检查供应商配置或短信可达性。

请求说明​

  • 请求类型:GET
  • 请求地址:/jim/users/password/status
  • 请求头:有效应用的 appkey 和登录返回的 Authorization 原文,不加 Bearer 前缀。
  • 必须是有效 ds1 用户会话或兼容期 legacy 用户 Token,遵守现有 设备登录策略。拒绝 API Key 和内部 service 凭证,即使 service 凭证携带用户 ID 也不允许查询。
  • 无请求体、无 user_id 参数。仅根据已验证的 app 和当前登录 requester 查询;额外传入 user_id 不会改变目标用户。
GET /jim/users/password/status HTTP/1.1
appkey: YOUR_APP_KEY
Authorization: USER_AUTHORIZATION_TOKEN

响应说明​

{"code":0,"msg":"success","data":{"has_password":false,"can_set_password_by_sms":true}}
字段类型说明
has_passwordboolean当前数据库 login_pass 非 NULL 且非空时为 true;不裁剪密码/hash。NULL 或空为 false,表示当前无密码,按首次设置展示;不推断历史是否设置过
can_set_password_by_smsboolean当前无密码且绑定了格式有效的手机号时才为 true,表示短信初设密码的资格,不表示已部署或短信可达、供应商已配置

手机号格式:大陆手机号 1[3-9][0-9]{9},或带 + 的国际号码(首位非零、7–15 位数字);不自动裁剪空白。已有密码时,即使绑定了有效手机号,can_set_password_by_sms 也为 false。

当前状态has_passwordcan_set_password_by_sms页面含义
无密码,有格式有效的手机号falsetrue首次设置状态,具备短信初设资格;需完成部署与供应商目的配置
无密码,无手机号或格式无效falsefalse首次设置状态,不具备短信初设资格
有密码truefalse修改密码状态

返回值是查询时快照,不是写入授权,也不是发送或 setpass 的前置调用要求。发送和提交均实时检查身份、密码状态和当前绑定号码。本接口不发送短信、不修改密码,也不改变现有 /jim/users/updpass 的行为。

错误说明​

code说明
17001缺少 appkey
17002应用不存在
17005未登录、无效 legacy Token、非用户身份、空 requester 或策略拒绝 legacy
17605ds1 无效或会话已撤销
17012当前应用下的当前用户不存在
17000密码状态查询数据库错误

既有鉴权中间件仍通过应用缓存预查应用;冷缓存下该预查的数据库故障可能返回 17002,尚未进入本接口状态查询。