/auth/recover-account
当用户无法访问主身份（邮箱或手机）时，通过预先设置的恢复联系人来验证身份并发起密码重置流程。参考：NIST SP 800-63B §5.1.1.2、OWASP ASVS V2.3。
请求体
Schema： service-identity/internal/handler/dto.RecoverAccountRequest
| 字段 | 类型 | 必填 | 示例 | 约束 | 描述 |
|---|---|---|---|---|---|
identity |
string |
是 | |||
tenant_id |
string |
否 | TenantID 显式租户（地址栏）：body > query > X-Tenant-ID；空即 400（AUTH-04/09）。 |
响应
| 状态 | 描述 | Schema |
|---|---|---|
| 200 | 恢复码已发送至受信任联系人 | service-identity/internal/handler/dto.RecoverAccountResponse |
| 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.RecoverAccountResponse
| 字段 | 类型 | 必填 | 示例 | 约束 | 描述 |
|---|---|---|---|---|---|
contact_types |
array of string |
否 | |||
expires_in |
integer |
否 | |||
masked_to |
string |
否 | |||
message |
string |
否 |