Saltar al contenido principal

Password Recovery Request

POST 
/company/auth/recovery

Endpoint para solicitar la recuperación de contraseña de usuarios de empresa. Realiza las siguientes operaciones:

  1. Valida el formato del email
  2. Busca el usuario en la base de datos
  3. Genera un token de recuperación único
  4. Envía email con enlace para restablecer contraseña

Flujo detallado:​

  1. Cliente envía email en formato JSON
  2. Servidor valida formato de email (401 si inválido)
  3. Busca usuario por email
  4. Genera token aleatorio
  5. Almacena token en base de datos asociado al usuario
  6. Envía email con enlace que contiene el token
  7. El enlace redirige a formulario para nueva contraseña

Seguridad:​

  • Por seguridad, siempre retorna 200 OK para no revelar emails registrados
  • Los tokens tienen validez limitada
  • Cada token es de un solo uso
  • Requiere HTTPS
  • Verifica también en usuarios deshabilitados (soft delete)

Comportamiento especial:​

  • Si el email no existe: retorna 200 con USER_NOT_FOUND
  • Si el usuario está deshabilitado: retorna 200 con USER_DISABLED
  • Usuarios demo (cia@testing.com, ciamu@testing.com): retornan 200 sin enviar email

Ejemplo de petición:​

{
  "email": "usuario@empresa.com"
}

Ejemplos de respuesta:​

Email válido encontrado:

{
  "op": "recovery",
  "message": "RECOVERY_EMAIL_SENT",
  "email": "usuario@empresa.com"
}

Email no encontrado (por seguridad retorna 200):

{
  "op": "recovery",
  "message": "USER_NOT_FOUND",
  "email": "noexiste@empresa.com"
}

Usuario deshabilitado:

{
  "op": "recovery",
  "message": "USER_DISABLED",
  "email": "usuario@empresa.com"
}

Códigos de error:​

  • 401: Email no proporcionado
  • 500: Error interno del servidor

Request​

Responses​

Procesado (siempre retorna 200 por seguridad)

Response Headers