Consultar Estado de Biometría

Consulta el estado de biometría del usuario autenticado y lista los dispositivos biométricos registrados (activos y revocados).

---

GET/auth/biometry/status

Obtiene estado y dispositivos biométricos del usuario

📤 Respuesta

{
"code": 1018,
"message": "PIN status retrieved successfully.",
"data": {
  "biometryConfigured": true,
  "totalDevices": 2,
  "activeDevices": 1,
  "revokedDevices": 1,
  "devices": [
    {
      "deviceId": "device-123",
      "deviceName": "iPhone 15",
      "platform": "ios",
      "algorithm": "P-256",
      "registeredAt": "2025-01-20T14:45:00.000Z",
      "status": "active"
    }
  ],
  "revokedDevicesList": [
    {
      "deviceId": "device-456",
      "deviceName": "Pixel 8",
      "platform": "android",
      "revokedAt": "2025-01-10T10:00:00.000Z",
      "status": "revoked"
    }
  ]
}
}

---

Headers

Header	Value
Authorization	Bearer <JWT>

---

Body

Este endpoint no requiere body.

---

Response (200)

Estado consultado

code 1018 — Devuelve si la biometría está configurada y el listado de dispositivos.

data

Campo	Tipo	Descripción
biometryConfigured	boolean	true si hay al menos 1 dispositivo activo (no revocado)
totalDevices	number	Cantidad total de dispositivos biométricos registrados
activeDevices	number	Cantidad de dispositivos activos
revokedDevices	number	Cantidad de dispositivos revocados
devices	array	Lista de dispositivos activos
revokedDevicesList	array	Lista de dispositivos revocados

Item de devices[] (activos)

Campo	Tipo	Descripción
deviceId	string	Identificador del dispositivo
deviceName	string	Nombre del dispositivo
platform	string	Plataforma del dispositivo
algorithm	string	Algoritmo
registeredAt	string	Timestamp ISO 8601 (fecha de registro)
status	"active"	Estado fijo "active"

Item de revokedDevicesList[] (revocados)

Campo	Tipo	Descripción
deviceId	string	Identificador del dispositivo
deviceName	string	Nombre del dispositivo
platform	string	Plataforma del dispositivo
revokedAt	string	Timestamp ISO 8601 (fecha de revocación)
status	"revoked"	Estado fijo "revoked"

---

Errores

Usuario no encontrado

HTTP 404 — code 4001.

{
  "code": 4001,
  "message": "User not found."
}

No autorizado

HTTP 401 — Token JWT inválido, expirado o ausente.

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

Error interno

HTTP 500 — code 5001.

{
  "code": 5001,
  "message": "Failed to save user to the database.",
  "details": "..."
}

---

Ejemplo (cURL)

curl -X GET 'https://api.swapbits.co/auth/biometry/status' \
  -H 'Authorization: Bearer YOUR_JWT_TOKEN'

---

⚡ Quick Test

GEThttps://api.swapbits.co/auth/biometry/status

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