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

Confirmación de Cuenta

GET
/api/confirm-account/{{id_cuenta}}

✅ GET /confirm-account/:token#

Confirma la cuenta de un vendedor utilizando un token único enviado por correo electrónico.

📍 Ruta#

GET /api/seller/confirm-account/:token

📝 Descripción#

Este endpoint permite confirmar el correo electrónico de un vendedor. Si el token es válido, se actualiza su cuenta:
confirmEmail: true
status: true
token: null (para evitar reuso)

🔓 Autenticación#

❌ No requiere autenticación.
🔑 El token en la URL actúa como autorización.

🧰 Middleware#

1.
validatePasswordRecoveryToken
2.
validateRequest

🧾 Parámetros de Ruta#

ParámetroTipoDescripción
tokenstringToken único enviado al correo del vendedor (requerido)

📦 Request Body#

Ninguno

✅ Respuestas#

✔️ 200 OK – Correo confirmado#

{
  "status": "success",
  "code": "EMAIL_CONFIRMED",
  "msg": "Correo confirmado exitosamente. Ya puedes iniciar sesión."
}

❌ Errores#

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

{
  "status": "error",
  "code": "MISSING_FIELD",
  "msg": "Falta el token de confirmación."
}
{
  "status": "error",
  "code": "VALIDATION_ERROR",
  "msg": "El formato del token no es válido."
}

❗ 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."
}

💥 500 Internal Server Error – Error inesperado#

{
  "status": "error",
  "code": "SERVER_ERROR",
  "msg": "Ha ocurrido un error inesperado al confirmar el correo. Intente de nuevo más tarde.",
  "info": {
    "detail": "Mensaje específico del error interno"
  }
}
Request Request Example
Shell
JavaScript
Java
Swift
curl --location -g --request GET 'https://back-prima-s-a.onrender.com/api/confirm-account/{{id_cuenta}}' \
--header 'User-Agent: insomnia/10.3.0'
Response Response Example
{}

Request

Header Params
User-Agent
string 
optional
Example:
insomnia/10.3.0

Responses

🟢200Success
application/json
Body
object {0}
Modified at 2025-04-26 00:17:46
Previous
Inicio de Sesión Vendedores
Next
Solicitud de restablecimiento de contraseña
Built with