Saltar al contenido principal

Eliminar Cuenta

Elimina la cuenta del usuario autenticado.

DELETE/auth/account

Elimina la cuenta del usuario autenticado


Autenticación

JWT Requerido

Se requiere un JWT válido en el header:

Authorization: Bearer <access_token>

Respuesta exitosa

Cuenta eliminada

Código 1012 — Eliminación realizada correctamente.

{
"code": 1012,
"message": "Account deleted successfully",
"data": {
"status": "success"
}
}

Errores

No autenticado

HTTP 401 Unauthorized

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

Error del servidor

HTTP 500 Internal Server Error

Nota: el endpoint devuelve un error genérico si algo falla.

{
"statusCode": 500,
"message": "Error deleting account."
}

Ejemplo (Frontend)

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

const data = await res.json();

if (res.ok && data.code === 1012) {
// limpiar sesión del cliente
localStorage.removeItem('accessToken');
sessionStorage.clear();
return data;
}

throw new Error(data.message || 'Delete account failed');
}