获取2FA状态
GET /api/user/2fa/status
查询当前用户的两步验证(2FA / TOTP)启用状态。
鉴权说明
用户控制台接口,需登录用户身份(会话 Cookie,或 Authorization: Bearer <access_token>,令牌由 生成访问令牌 获取)。未登录返回 401。
响应字段(200)
| 字段名 | 类型 | 说明 |
|---|---|---|
success | boolean | 是否成功 |
message | string | 提示信息 |
data | object | 状态数据 |
data.enabled | boolean | 是否已启用 2FA |
data.locked | boolean | 是否被锁定 |
data.backup_codes_remaining | integer | 剩余可用备用码数量。仅在 enabled 为 true 时返回。 |
响应示例
JSON · 已启用
{
"success": true,
"message": "",
"data": {
"enabled": true,
"locked": false,
"backup_codes_remaining": 8
}
}
JSON · 未启用
{
"success": true,
"message": "",
"data": {
"enabled": false,
"locked": false
}
}