/auth/recovery/request
通过邮箱或手机号发起账户恢复流程，生成恢复令牌并向受信任联系人发送验证码，支持将恢复码发送至备用邮箱或手机。参考：NIST SP 800-63B §5.1.1.2、OWASP ASVS V2.3。
请求体
Schema： service-identity/internal/handler/dto.RequestAccountRecoveryRequest
| 字段 | 类型 | 必填 | 示例 | 约束 | 描述 |
|---|---|---|---|---|---|
identity |
string |
是 | john@example.com |
已知的身份标识 | |
method |
string |
是 | enum: `backup_email`, `security_qa`, `trusted_device`, `sms` | 恢复方法 | |
tenant_id |
string |
否 | TenantID 公开面无 JWT：显式 body 租户优先于 X-Tenant-ID / 默认租户。 |
响应
| 状态 | 描述 | Schema |
|---|---|---|
| 200 | 恢复流程已发起，恢复令牌和掩码联系方式已返回 | service-identity/internal/handler/dto.RequestAccountRecoveryResponseWrapper |
| 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.RequestAccountRecoveryResponseWrapper
| 字段 | 类型 | 必填 | 示例 | 约束 | 描述 |
|---|---|---|---|---|---|
code |
integer |
否 | |||
message |
string |
否 | |||
timestamp |
string |
否 |