Login Administradores
POST
/api/login-admin
📝 POST /login-admin
📍 Ruta
POST /api/login-admin📝 Descripción
📦 Request Body
{
"username": "nombre_de_usuario_admin",
"password": "la_contraseña_del_admin"
}⚙️ Flujo de Ejecución
1.
username y password estén presentes y cumplan los formatos definidos.2.
admins model) por username.3.
status === true.status === false), responde con 403 Forbidden.4.
bcrypt.compare (método matchPassword) para comparar las contraseñas.chances.chances llega a 0, se bloquea la cuenta (status = false).lastLogin con la fecha y hora actual.chances a 3._id y role = "admin".5.
✅ Respuestas Posibles
✔️ 200 OK – Login exitoso
{
"status": "success",
"code": "LOGIN_SUCCESS",
"msg": "Inicio de sesión exitoso para 'admin_user'.",
"data": {
"admin": {
"_id": "...",
"username": "admin_user",
"role": "admin",
"createdAt": "...",
"lastLogin": "..."
},
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}
}🚫 400 Bad Request – Campos faltantes o formato inválido
{
"status": "error",
"code": "MISSING_FIELD", // o código de validación específico
"msg": "Los campos 'username' y 'password' son obligatorios."
}🚫 401 Unauthorized – Contraseña incorrecta
{
"status": "error",
"code": "INVALID_CREDENTIALS",
"msg": "Contraseña errónea. Le quedan X intentos."
// o "Contraseña errónea. La cuenta ha sido bloqueada."
}🚫 403 Forbidden – Cuenta bloqueada
{
"status": "error",
"code": "ACCOUNT_LOCKED",
"msg": "La cuenta del administrador 'admin_user' está bloqueada."
}🚫 404 Not Found – Administrador no existe
{
"status": "error",
"code": "NOT_FOUND",
"msg": "No se encontró administrador con username 'admin_user'."
}💥 500 Internal Server Error – Error inesperado
{
"status": "error",
"code": "SERVER_ERROR",
"msg": "Ha ocurrido un error inesperado al intentar iniciar sesión. Intente de nuevo más tarde."
}Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://back-prima-s-a.onrender.com/api/login-admin' \
--header 'Content-Type: application/json' \
--data-raw '{
"username": "UserAdmin",
"password": "PassAdmin"
}'Response Response Example
{
"msg": "Inicio de sesion exitoso",
"inf": {
"_id": "67624f907669c906ca34a8de",
"username": "UserAdmin",
"role": "admin",
"createdAt": "2024-12-17T12:00:00.000Z"
},
"tokenJWT": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjY3NjI0ZjkwNzY2OWM5MDZjYTM0YThkZSIsInJvbCI6ImFkbWluIiwiaWF0IjoxNzQyODQzNzUwLCJleHAiOjE3NDI4NzI1NTB9.4AWcgFdvlxB1qr2WC8yk1c3ki0I3vK8JqJZZrVYaVYs"
}Request
Body Params application/json
Responses
Modified at 2025-06-14 22:40:54