Fitly Public API

Documentación completa de la API pública para gestión de entrenamientos personales.

Todos los endpoints requieren autenticación mediante API Key. Incluye tu API Key en el header Authorization como: Bearer pk_YOUR_API_KEY

Base URL

/api/public/v1

JSON (application/json)

1000 requests/hour

Gestión completa de clientes (CRUD)

/clients, /clients/:id

Librería de ejercicios (global, empresa, personal)

/exercises, /exercises/:id

Entrenamientos asignados por fecha

/workouts, /workouts/:id

Resultados de ejercicios completados

/results, /results/:id

Plantillas reutilizables de entrenamientos

/templates, /templates/:id

Gestión de empresas (admin/gestor)

/companies, /companies/:id

Catálogo de tipos por empresa (Yoga, CrossFit, Spinning...).

/class-types, /class-types/:id

Plantillas de clase (recurrentes o puntuales) con docente, cupo y ventanas de reserva.

/classes, /classes/:id

Instancias materializadas en fechas concretas con contadores de cupo y lista de espera.

/class-instances, /class-instances/:id

Reservar plaza, lista de espera, cancelar (con devolución de crédito si se cancela dentro de plazo).

/class-instances/:id/bookings, /class-bookings/mine, /class-bookings/:id

Rol	Descripción	Acceso Principal
admin	Administrador del sistema	Acceso total a todas las entidades y empresas
gestor	Gestor de empresa	Gestiona su empresa, entrenadores y clientes
entrenador	Entrenador	Gestiona sus clientes, plantillas y ejercicios
cliente	Cliente	Ve sus entrenamientos y añade resultados
personal-trainer	Entrenador personal independiente	Combina gestor + entrenador para su empresa
autoentrenador	Cliente que se entrena a sí mismo	Crea y gestiona sus propios entrenamientos