POST /auth/reset-password

使用验证码验证通过后设置新密码,支持邮箱和短信两种验证方式。参考:NIST SP 800-63B §5.1.1.2、OWASP ASVS V2.1。

身份认证 None application/json

请求体

Schema: service-identity/internal/handler/dto.ResetPasswordRequest

字段类型必填示例约束描述
code string 是 Verification code
identity string 是 Email or phone
new_password string 是
password_transmission string 否 plain|hash|symmetric|asymmetric
tenant_id string 否 TenantID 显式租户(地址栏):body > query > X-Tenant-ID;空即 400(AUTH-04/09)。

响应

状态描述Schema
200密码重置成功service-identity/internal/handler/dto.ResetPasswordResponse
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.ResetPasswordResponse

重置密码响应

字段类型必填示例约束描述
message string 否 Message