GrowUpMy Master API v3.1

Documentación técnica autogenerada para el ecosistema de servicios.

Autenticación y Seguridad

POST /login

Inicia sesión y obtiene los datos del usuario.

Parámetros Esperados

  • email: Email
  • password: Contraseña
POST /logout

Cierra sesión.

Parámetros Esperados

  • email: Email
  • password: Contraseña
POST /password/forgot

Solicita un enlace de recuperación de contraseña.

Parámetros Esperados

  • email: Email
POST /password/reset

Restablece la contraseña utilizando un token válido.

Parámetros Esperados

  • token: Token recibido
  • password: Nueva contraseña
POST /auth/me

Sesión actual: requiere Authorization Bearer. Renueva expiración y devuelve datos mínimos del usuario.

POST /auth/verify-email

Confirma correo y teléfono del alta con el token recibido por email (público).

Parámetros Esperados

  • token: Token del enlace
POST /auth/resend-verification

Reenvía el correo de verificación (requiere sesión).

Gestión de Perfiles

GET /profile

Obtiene todo el perfil: profile, services, category_hero_templates, has_online_availability, availability_rules_weekly (full=1), reviews (solo aprobadas en público), categories_flat, booking_settings/conduct cuando full=1. En modo público (full=0), opcional Authorization Bearer: si el visitante es otro usuario autenticado, incluye viewer_review_eligibility (reservas completadas aún sin reseña).

Parámetros Esperados

  • id: ID del usuario
  • full: 1 para datos administrativos
POST /profile/update

Actualiza el perfil profesional y características (badges).

Parámetros Esperados

  • id: ID del usuario
  • name: Nombre
  • features: JSON
POST /professionals/register

Registra un nuevo profesional en la plataforma.

GET /professionals/browse

Listado público de profesionales (sin autenticación). Filtros: category_id, category_slug (hogar|gastro; resuelve slugs legacy), q.

Parámetros Esperados

  • category_id: opcional
  • category_slug: opcional
  • q: opcional
POST /professionals/conduct-accept

Registra la aceptación del compromiso de buena fe con clientes (requiere sesión; dueño del perfil).

POST /reviews/submit

Cliente autenticado: envía reseña (rating 1–5, comentario opcional) para una reserva completada propia. Comentario vacío válido; si hay texto debe superar un mínimo de caracteres (no publica frases de una sola palabra). Moderación automática; rechazo (422) reduce algo rating_avg del solicitante; aprobación (200) deja la reseña pública.

Parámetros Esperados

  • booking_id: ID de la reserva
  • rating: 1-5
  • comment: texto opcional

Reservas (Bookings)

POST /pro/metrics

Métricas agregadas del negocio para el profesional autenticado (mismas ventanas de tiempo que el listado de reservas).

POST /bookings

Lista las reservas asociadas a un usuario o profesional.

Parámetros Esperados

  • user_id: ID
  • role: pro|client (perspectiva en la reserva, mismo user_id)
  • period: upcoming/past
POST /bookings/create

Crea una nueva reserva de servicio.

Parámetros Esperados

  • professional_id: ID
  • preferred_time: ISO Date
POST /bookings/manual-request

Solicitud presencial/virtual cuando el profesional no tiene horarios online; notifica por correo.

Parámetros Esperados

  • professional_id: ID
  • modality: presencial|virtual
  • customer_name: Nombre
POST /bookings/validate

Valida un código de referencia de reserva (GRW-XXXXX).

Parámetros Esperados

  • reference_code: Código
POST /bookings/cancel

Cancela una reserva existente.

Parámetros Esperados

  • booking_id: ID
POST /bookings/status/update

Cambia el estado de una reserva (confirmada, completada, etc).

Parámetros Esperados

  • booking_id: ID
  • new_status: Estado

Servicios y Disponibilidad

GET /categories

Obtiene el listado de categorías de servicios.

Parámetros Esperados

  • parent_id: Opcional (hijas de esa raíz)
  • flat: 1 = todas activas con parent_id (editor de perfil)
GET /services

Busca servicios activos por categoría.

Parámetros Esperados

  • category_id: ID
POST /professionals/availability

Huecos por fecha, calendario mensual (calendar_month YYYY-MM), o guardar reglas (save=1 + auth).

Parámetros Esperados

  • pro_id: ID
  • date: Fecha (sin calendar_month)
  • calendar_month: YYYY-MM opcional
  • save: 1 para guardar
POST /update_service_link

Actualiza el enlace de reunión (Meet/Zoom) de un servicio.

Parámetros Esperados

  • service_id: ID
  • meeting_link: URL

Soporte y Leads

POST /tickets

Obtiene el historial de tickets de un usuario.

Parámetros Esperados

  • email: Email
POST /tickets/create

Genera un nuevo ticket de soporte técnico.

Parámetros Esperados

  • email: Email
  • subject: Asunto
  • category: Categoría
POST /leads/subscribe

Registra un interesado en la lista de espera.

Parámetros Esperados

  • email: Email
POST /contact

Envía el formulario de contacto por correo (sin auth). topic = clave de alias: hola, soporte, legal, partner, marketing (ver config contact_aliases).

Parámetros Esperados

  • name: Nombre
  • email: Email del remitente
  • topic: Clave motivo (hola|soporte|legal|partner|marketing)
  • message: Mensaje
  • company: Honeypot (vacío)