Saltar al contenido principal

Consultar Estado de 2FA

Endpoint para verificar el estado actual de la autenticación de dos factores (2FA) en la cuenta del usuario autenticado.

🔍 Verificación de Estado 2FA

Permite consultar si 2FA está habilitado en tu cuenta. Es útil para mostrar opciones de seguridad en la UI (activar/desactivar 2FA) y ajustar flujos de login.

GET/auth/account/2fa/status

Verifica si el usuario tiene 2FA habilitado

📤 Respuesta

{
"code": 2004,
"message": "Two-factor authentication status",
"data": {
  "status": "success",
  "enabled": true
}
}

Autenticación​

JWT Requerido

Este endpoint requiere un JWT válido:

Authorization: Bearer <access_token>

Respuestas​

✅ 2FA habilitado​

2FA Activado

Código 2004 - Consulta exitosa.

{
  "code": 2004,
  "data": {
    "status": "success",
    "enabled": true
  }
}

⚠️ 2FA deshabilitado​

2FA Desactivado

Código 2004 - Consulta exitosa.

{
  "code": 2004,
  "data": {
    "status": "success",
    "enabled": false
  }
}

❌ No autenticado​

Usuario No Autenticado

HTTP 401 - JWT inválido, expirado o ausente.

{
  "code": 401,
  "message": "Unauthorized"
}

Ejemplo JavaScript/TypeScript​

async function check2FAStatus(accessToken) {
  const res = await fetch('https://api.swapbits.co/auth/account/2fa/status', {
    method: 'GET',
    headers: { 'Authorization': `Bearer ${accessToken}` }
  });

  const result = await res.json();

  if (result.code === 2004) {
    return result.data.enabled; // true | false
  }

  throw new Error(result.message || 'Error checking 2FA status');
}

⚡ Quick Test​

GEThttps://api.swapbits.co/auth/account/2fa/status
curl -X GET 'https://api.swapbits.co/auth/account/2fa/status' \
  -H 'Content-Type: application/json'

📝 Notas​

🔐 Solo lectura

Este endpoint no modifica la configuración del usuario. Para activar o desactivar 2FA utiliza:

🔗 Enlaces Relacionados​