Restablecimiento de contraseña
POST
/api/recovery-password/i08omsn5zfk
🔐 POST /recovery-password/:token
📍 Ruta
POST /api/recovery-password/:token📝 Descripción
Verifica que el token sea válido y no haya expirado, que ambas contraseñas coincidan, y actualiza la contraseña de la cuenta. Una vez completado el proceso, el token se invalida para prevenir reutilización.
🔐 Autenticación
🧰 Middleware
1.
validateNewPassword – Verifica que password y confirmpassword estén presentes, cumplan requisitos mínimos y coincidan.2.
validateRequest – Manejo de errores de validación.🔢 Parámetros
🛣️ Path Parameters
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
token | string | ✅ | Token de recuperación enviado al correo del usuario |
📥 Request Body
{
"password": "string (requerido)",
"confirmpassword": "string (requerido)"
}✅ Respuestas
✔️ 200 OK – Contraseña actualizada correctamente
{
"status": "success",
"code": "PASSWORD_UPDATED",
"msg": "Contraseña actualizada correctamente. Ya puedes iniciar sesión con tu nueva contraseña."
}❌ Errores
⚠️ 400 Bad Request – Campos faltantes o inválidos
{
"status": "error",
"code": "MISSING_FIELD",
"msg": "Debes proporcionar la nueva contraseña y su confirmación."
}⚠️ 400 Bad Request – Contraseñas no coinciden
{
"status": "error",
"code": "PASSWORD_MISMATCH",
"msg": "Las contraseñas no coinciden."
}🕳️ 404 Not Found – Token inválido o expirado
{
"status": "error",
"code": "INVALID_OR_EXPIRED_TOKEN",
"msg": "El token es inválido, ya ha sido utilizado o ha expirado. No se puede cambiar la contraseña."
}💥 500 Internal Server Error – Falla inesperada
{
"status": "error",
"code": "SERVER_ERROR",
"msg": "Ha ocurrido un error inesperado al establecer la nueva contraseña. Intente de nuevo más tarde.",
"info": {
"detail": "Database save failed"
}
}Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://back-prima-s-a.onrender.com/api/recovery-password/i08omsn5zfk' \
--header 'User-Agent: insomnia/10.3.0' \
--header 'Content-Type: application/json' \
--data-raw '{
"password":"123456",
"confirmpassword":"123456"
}'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-24 17:56:38