POST /auth/recovery/complete

验证恢复码和恢复令牌后设置新密码,自动撤销所有会话以确保账户安全,并发送密码变更通知。参考:NIST SP 800-63B §5.1.1.2、OWASP ASVS V2.1。

身份认证 None application/json

请求体

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 否