NATSidentity.user.verify-password校验用户密码

校验密码是否与存储的哈希匹配;结果计入 attempt_service 的评分(密码因素)。

Request Payload

消息格式:JSON

NameData TypeRequiredDescription
userIdstringYes用户 ID
passwordstringYes明文密码
type RequestBody = {
  /** 用户 ID */
  userId: string
  /** 明文密码 */
  password: string
}
{
  "userId": "01JD8SEGQ0P9N2XK4L7VDH3T6C",
  "password": "J8v#pQ2mXs!a"
}

Response Payload

回复使用统一信封 {id, code, messages, result},其 result:

NameData TypeRequiredDescription
validbooleanYes密码是否匹配
type ResponseBody = {
  /** 密码是否匹配 */
  valid: boolean
}
{
  "valid": true
}

Response Code

回复使用统一信封 {id, code, messages, result},其 code 字段:

code Meaning Notes
0 成功 校验用户密码
2001 密码不匹配 用户不存在时同样返回,避免账号枚举

Examples

{ "userId": "01JD8SEGQ0P9N2XK4L7VDH3T6C", "password": "J8v#pQ2mXs!a" }
{
  "id": "01JD8SUS6N8X4Z1AW",
  "code": 0,
  "messages": [],
  "result": { "valid": true }
}

Remarks

校验失败时 messages 不区分用户存在与否,避免账号枚举。