Prima-Back
  1. Modulo Vendedores
Prima-Back
  • API DOCUMENTATION
  • Principal
    • /
      GET
  • Modulo Administradores
    • Vendedores Operaciones
      • Registro de Vendedores
      • Visualizar Vendedores
      • Visualizar Vendedores por Mongo ID
      • Visualizar Vendedores por cedula
      • Actualizar Vendedor
      • Eliminar Vendedor
    • Estadisticas
      • Estadisticas de documentos
      • Visualizacion de top Vendedores
      • Visualizar Ventas por Vendedor
    • Login Administradores
      POST
    • Recuperacion de contraseña Administrador
      POST
  • Modulo Vendedores
    • Inicio de Sesión Vendedores
      POST
    • Confirmación de Cuenta
      GET
    • Solicitud de restablecimiento de contraseña
      POST
    • Restablecimiento de contraseña
      POST
  • Modulo Clientes
    • Registrar Cliente
      POST
    • Visualizar Clientes
      GET
    • Visualizar Clientes por RUC
      GET
    • Actualizar Cliente
      PATCH
    • Eliminar Cliente
      DELETE
  • Modulo Productos
    • Crear Producto
      POST
    • Visualizar Productos
      GET
    • Visualizar Productos por ID
      GET
    • Actualizar Producto
      PATCH
    • Eliminar Producto
      DELETE
  • Modulo Pedidos
    • Crear Orden
      POST
    • Visualizar Ordenes
      GET
    • Visualizar Ordenes por ID
      GET
    • Actualizar Orden
      PATCH
    • Actualizar Estado de Orden
      PATCH
    • Eliminar Orden
      DELETE
  1. Modulo Vendedores

Solicitud de restablecimiento de contraseña

POST
/api/recovery-password

🔐 POST /recovery-password#

Inicia el proceso de recuperación de contraseña para un vendedor mediante su correo electrónico.

📍 Ruta#

POST /api/recovery-password

📝 Descripción#

Permite a un vendedor iniciar el proceso de recuperación de contraseña. Si el email existe en el sistema, se genera un token, se guarda y se envía un correo con instrucciones. La respuesta es siempre genérica para no revelar si el email existe o no.

🔓 Autenticación#

❌ No requiere autenticación previa.

🧰 Middleware#

1.
validateSellerPasswordRecoveryRequest
2.
validateRequest

📦 Request Body#

{
  "email": "string"
}
📌 Debe ser un email válido y obligatorio.

✅ Respuestas#

✔️ 200 OK – Solicitud procesada#

{
  "status": "success",
  "code": "RECOVERY_EMAIL_SENT_IF_EXISTS",
  "msg": "Si existe una cuenta asociada a {email}, se ha enviado un correo con instrucciones para recuperar la contraseña."
}

❌ Errores#

🚫 400 Bad Request – Campo faltante o inválido#

{
  "status": "error",
  "code": "MISSING_FIELD",
  "msg": "El campo 'email' es obligatorio."
}
{
  "status": "error",
  "code": "VALIDATION_ERROR",
  "msg": "El formato del email es inválido."
}

💥 500 Internal Server Error – Fallo al enviar el correo#

{
  "status": "error",
  "code": "EMAIL_SEND_FAILED",
  "msg": "Se inició el proceso de recuperación, pero hubo un problema crítico al enviar el correo a {email}. Intenta de nuevo o contacta a soporte.",
  "info": {
    "emailDetails": {
      "sent": false,
      "message": "Mensaje específico del error de envío"
    }
  }
}

⚠️ 500 Internal Server Error – Error inesperado#

{
  "status": "error",
  "code": "SERVER_ERROR",
  "msg": "Ha ocurrido un error inesperado al procesar la solicitud de recuperación de contraseña. Intente de nuevo más tarde.",
  "info": {
    "detail": "Mensaje específico del error interno"
  }
}
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://back-prima-s-a.onrender.com/api/recovery-password' \
--header 'User-Agent: insomnia/10.3.0' \
--header 'Content-Type: application/json' \
--data-raw '{
    "email": "tu_correo@example.com"
}'
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
email
string 
required
Examples

Responses

🟢200Success
application/json
Body
object {0}
Modified at 2025-04-26 00:06:20
Previous
Confirmación de Cuenta
Next
Restablecimiento de contraseña
Built with