/auth/recovery/complete
验证恢复码和恢复令牌后设置新密码,自动撤销所有会话以确保账户安全,并发送密码变更通知。参考:NIST SP 800-63B §5.1.1.2、OWASP ASVS V2.1。
请求体
Schema: service-identity/internal/handler/dto.CompleteAccountRecoveryRequest
| 字段 | 类型 | 必填 | 示例 | 约束 | 描述 |
|---|---|---|---|---|---|
code |
string |
是 | 验证码 | ||
new_password |
string |
是 | 新密码 | ||
recovery_token |
string |
是 | 恢复令牌 | ||
password_transmission |
string |
否 | plain|hash|symmetric|asymmetric | ||
tenant_id |
string |
否 | TenantID 显式租户(地址栏)。非空时必须与令牌租户一致;空 = 令牌权威。 |
响应
| 状态 | 描述 | Schema |
|---|---|---|
| 200 | 账户恢复完成,密码已重置 | service-identity/internal/handler/dto.CompleteAccountRecoveryResponse |
| 400 | 请求参数无效或恢复令牌已过期 | service-core/base/dto.SimpleResponse |
| 500 | 服务器内部错误 | service-core/base/dto.SimpleResponse |
引用的 Schema
service-core/base/dto.SimpleResponse
| 字段 | 类型 | 必填 | 示例 | 约束 | 描述 |
|---|---|---|---|---|---|
code |
integer |
否 | |||
message |
string |
否 | |||
timestamp |
string |
否 |
service-identity/internal/handler/dto.CompleteAccountRecoveryResponse
| 字段 | 类型 | 必填 | 示例 | 约束 | 描述 |
|---|---|---|---|---|---|
message |
string |
否 |