/auth/recovery/verify
验证从受信任联系人收到的恢复码,验证成功后返回确认,允许用户进入密码重置步骤。参考:NIST SP 800-63B §5.1.1.2、OWASP ASVS V2.3。
请求体
Schema: service-identity/internal/handler/dto.VerifyAccountRecoveryRequest
| 字段 | 类型 | 必填 | 示例 | 约束 | 描述 |
|---|---|---|---|---|---|
code |
string |
是 | 验证码 | ||
recovery_token |
string |
是 | 恢复令牌 | ||
tenant_id |
string |
否 | TenantID 显式租户(地址栏)。非空时必须与令牌租户一致;空 = 令牌权威。 |
响应
| 状态 | 描述 | Schema |
|---|---|---|
| 200 | 恢复验证码校验成功 | service-core/base/dto.SimpleResponse |
| 400 | 请求参数无效或恢复码已过期 | service-core/base/dto.SimpleResponse |
| 500 | 服务器内部错误 | service-core/base/dto.SimpleResponse |
引用的 Schema
service-core/base/dto.SimpleResponse
| 字段 | 类型 | 必填 | 示例 | 约束 | 描述 |
|---|---|---|---|---|---|
code |
integer |
否 | |||
message |
string |
否 | |||
timestamp |
string |
否 |