Revocar Dispositivo Biométrico

Revoca un dispositivo biométrico del usuario autenticado. Una vez revocado, el dispositivo deja de ser válido para generar/verificar autenticaciones biométricas.

---

POST/auth/biometry/revoke

Revoca un dispositivo biométrico por deviceId

📋 Parámetros

deviceIdstringrequerido

Device ID del dispositivo biométrico a revocar

📤 Respuesta

{
"code": 1022,
"message": "Biometric device revoked successfully.",
"data": {
  "deviceId": "550e8400-e29b-41d4-a716-446655440000",
  "status": "revoked",
  "revokedAt": "2025-01-20T14:45:00.000Z"
}
}

---

Headers

Header	Value
Authorization	Bearer <JWT>
Content-Type	application/json

---

Body

{
  "deviceId": "550e8400-e29b-41d4-a716-446655440000"
}

Campos

Campo	Tipo	Requerido	Descripción
deviceId	string	Sí	Identificador del dispositivo

---

Response (200)

Dispositivo revocado

code 1022 — Biometric device revoked successfully.

{
  "code": 1022,
  "message": "Biometric device revoked successfully.",
  "data": {
    "deviceId": "550e8400-e29b-41d4-a716-446655440000",
    "status": "revoked",
    "revokedAt": "2025-01-20T14:45:00.000Z"
  }
}

data

Campo	Tipo	Descripción
deviceId	string	ID del dispositivo revocado
status	"revoked"	Estado fijo "revoked"
revokedAt	string	Timestamp ISO 8601

---

Errores

deviceId faltante

HTTP 400 — code 4006.

{
  "code": 4006,
  "message": "deviceId is required"
}

Usuario no encontrado

HTTP 404 — code 4001.

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

Dispositivo no encontrado

HTTP 404 — code 5012.

{
  "code": 5012,
  "message": "Device 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 POST 'https://api.swapbits.co/auth/biometry/revoke' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer YOUR_JWT_TOKEN' \
  -d '{
    "deviceId": "550e8400-e29b-41d4-a716-446655440000"
  }'

---

⚡ Quick Test

POSThttps://api.swapbits.co/auth/biometry/revoke

curl -X POST 'https://api.swapbits.co/auth/biometry/revoke' \
  -H 'Content-Type: application/json' \
  -d '{
"deviceId": "550e8400-e29b-41d4-a716-446655440000"
}'