获取备用验证码状态

GET/web/v1/system/security/mfa/backup-codes JWT

获取用户备用验证码的状态，包括剩余未使用数量和初始生成总数。不会返回实际的备用验证码。

鉴权

Auth Chain: WEB Chain — 需要 Authorization: Bearer <jwt> 以下请求头由系统自动注入（前端无需处理）： X-PORTAL-ACCESS-CODE (Nginx), X-Request-Id (Gateway)

请求参数

无需请求参数。

请求示例

无需请求体。

成功响应

成功 200

{
  "version": "1.3.0",
  "timestamp": 1709337600000,
  "success": true,
  "code": "2000",
  "message": "SUCCESS",
  "data": {
    "remainingCount": 10,
    "totalGenerated": 10
  }
}

字段	类型	说明
remainingCount	integer	剩余未使用的备用验证码数量
totalGenerated	integer	初始生成的验证码总数（默认 10）

错误响应

未授权 401

{
  "success": false,
  "code": "4010",
  "message": "Invalid or expired token"
}

说明

• 仅返回数量，不返回实际验证码。
• totalGenerated 为初始生成的数量（默认 10）。
• 每次使用备用验证码后，remainingCount 减少 1。