功能说明
进入密码界面时调用独立轻量接口,以当前数据库状态决定展示“首次设置”还是“修改密码”。不需要读取完整用户信息或复用用户资料缓存,不返回手机号、密码或 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_password | boolean | 当前数据库 login_pass 非 NULL 且非空时为 true;不裁剪密码/hash。NULL 或空为 false,表示当前无密码,按首次设置展示;不推断历史是否设置过 |
| can_set_password_by_sms | boolean | 当前无密码且绑定了格式有效的手机号时才为 true,表示短信初设密码的资格,不表示已部署或短信可达、供应商已配置 |
手机号格式:大陆手机号 1[3-9][0-9]{9},或带 + 的国际号码(首位非零、7–15 位数字);不自动裁剪空白。已有密码时,即使绑定了有效手机号,can_set_password_by_sms 也为 false。
| 当前状态 | has_password | can_set_password_by_sms | 页面含义 |
|---|---|---|---|
| 无密码,有格式有效的手机号 | false | true | 首次设置状态,具备短信初设资格;需完成部署与供应商目的配置 |
| 无密码,无手机号或格式无效 | false | false | 首次设置状态,不具备短信初设资格 |
| 有密码 | true | false | 修改密码状态 |
返回值是查询时快照,不是写入授权,也不是发送或 setpass 的前置调用要求。发送和提交均实时检查身份、密码状态和当前绑定号码。本接口不发送短信、不修改密码,也不改变现有 /jim/users/updpass 的行为。
错误说明
| code | 说明 |
|---|---|
| 17001 | 缺少 appkey |
| 17002 | 应用不存在 |
| 17005 | 未登录、无效 legacy Token、非用户身份、空 requester 或策略拒绝 legacy |
| 17605 | ds1 无效或会话已撤销 |
| 17012 | 当前应用下的当前用户不存在 |
| 17000 | 密码状态查询数据库错误 |
既有鉴权中间件仍通过应用缓存预查应用;冷缓存下该预查的数据库故障可能返回 17002,尚未进入本接口状态查询。