Recuperacion de contraseña Administrador
POST
/api/recovery-password-admin
🛠️ POST /recovery-password-admin
📍 Ruta
POST /api/recovery-password-admin📝 Descripción
🔐 Autenticación
🧰 Middleware
1.
validateAdminPasswordRecovery – Valida que username esté presente.2.
validateRequest – Manejo general de errores de validación.📦 Request Body
{
"username": "string (requerido)"
}✅ Respuestas
✔️ 200 OK – Contraseña generada y correo enviado
{
"status": "success",
"code": "PASSWORD_RECOVERY_SUCCESS",
"msg": "Nueva contraseña generada y enviada al correo de la empresa para el usuario '{username}'.",
"info": {
"emailDetails": {
"sent": true,
"message": "Correo enviado correctamente."
}
}
}⚠️ 200 OK – Contraseña actualizada pero correo falló
{
"status": "warning",
"code": "EMAIL_WARNING",
"msg": "Contraseña actualizada para '{username}', pero hubo un problema al enviar el correo de notificación a la empresa.",
"info": {
"emailDetails": {
"sent": false,
"message": "Error específico del servicio de correo (ej: 'Connection refused')."
}
}
}❌ Errores
🚫 400 Bad Request – Campo faltante o inválido
{
"status": "error",
"code": "MISSING_FIELD", // o "VALIDATION_ERROR"
"msg": "El campo 'username' es obligatorio."
// "errors": [...]
}🔍 404 Not Found – Administrador no existe
{
"status": "error",
"code": "NOT_FOUND",
"msg": "No se encontró administrador con username '{username}'."
}💥 500 Internal Server Error – Error inesperado
{
"status": "error",
"code": "SERVER_ERROR",
"msg": "Ha ocurrido un error inesperado al recuperar la contraseña. Intente de nuevo más tarde.",
"info": {
"detail": "Mensaje específico del error interno (ej: 'Database connection failed')",
"emailAttempted": true,
"emailDetails": {
"sent": false,
"message": "Mensaje de error del servicio de correo si falló antes del error principal"
}
}
}Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://back-prima-s-a.onrender.com/api/recovery-password-admin' \
--header 'User-Agent: insomnia/10.3.0' \
--header 'Content-Type: application/json' \
--data-raw '{
"username": "UserAdmin"
}'Response Response Example
{}Request
Header Params
Content-Type
string
optional
Example:
application/json
User-Agent
string
optional
Example:
insomnia/10.3.0
Body Params application/json
Responses
Modified at 2025-04-26 00:24:05