跳到主要内容

获取2FA状态

GET /api/user/2fa/status

查询当前用户的两步验证(2FA / TOTP)启用状态。

鉴权说明

用户控制台接口,需登录用户身份(会话 Cookie,或 Authorization: Bearer <access_token>,令牌由 生成访问令牌 获取)。未登录返回 401。

响应字段(200)​

字段名类型说明
successboolean是否成功
messagestring提示信息
dataobject状态数据
data.enabledboolean是否已启用 2FA
data.lockedboolean是否被锁定
data.backup_codes_remaininginteger剩余可用备用码数量。仅在 enabled 为 true 时返回。

响应示例​

JSON · 已启用
{
"success": true,
"message": "",
"data": {
"enabled": true,
"locked": false,
"backup_codes_remaining": 8
}
}
JSON · 未启用
{
"success": true,
"message": "",
"data": {
"enabled": false,
"locked": false
}
}