Saltar a contenido

API de Análisis de Carga de Volumen

Convierte las métricas de volumen de entrenamiento en clasificación de hipertrofia y orientación de programación basada en el riesgo.

Endpoint

  • GET /api/v1/fitness/volume-load-analysis
  • POST /api/v1/fitness/volume-load-analysis/post

Parámetros

Nombre Tipo Requerido In Descripción
total_sets entero (1-60) Sí Consulta/Cuerpo Número de series por semana.
avg_reps número (1-40) Sí Consulta/Cuerpo Número promedio de repeticiones por serie.
avg_load número (1-500) Sí Consulta/Cuerpo Carga promedio por repetición (contexto equivalente a kg).
muscle_group cadena Sí Consulta/Cuerpo chest, back, legs, shoulders, arms, glutes, core, full_body.
lang cadena No Consulta Idioma de la respuesta (en, es, de, fr, pt, ja, hi, ar).

¿Por qué utilizar este endpoint?

  • Clasificar la carga de entrenamiento contra las zonas de hipertrofia.
  • Detectar patrones de sobrecarga antes del fallo de recuperación.
  • Proporcionar a los paneles de control del entrenador señales de volumen interpretables.

Comenzar

Ejemplo de solicitud

curl -X GET "https://api.hefitapi.com/api/v1/fitness/volume-load-analysis?total_sets=18&avg_reps=10&avg_load=75&muscle_group=legs&lang=en" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.hefitapi.com/api/v1/fitness/volume-load-analysis/post?lang=en" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"total_sets":26,"avg_reps":12,"avg_load":68,"muscle_group":"back"}'

Ejemplo de respuesta

Info

El siguiente ejemplo de respuesta es solo para demostración. Para obtener la estructura JSON completa, en tiempo real y potencialmente más rica, realice una solicitud en vivo a este endpoint.

{
  "muscle_group": "legs",
  "muscle_group_label": "Legs",
  "total_sets": 18,
  "avg_reps": 10.0,
  "avg_load": 75.0,
  "weekly_volume_load": {"tonnage": 13500, "per_set_density": 750.0},
  "hypertrophy_zone_classification": {"zone": "hypertrophy_optimal", "zone_label": "Hypertrophy Optimal", "insight": "Current load is well-positioned for growth adaptation."},
  "overuse_warning": {"level": "low", "level_label": "Low"},
  "hypertrophy_efficiency_score": 100,
  "load_distribution_note": "Balanced volume and intensity profile.",
  "recommendations": ["Maintain progression while protecting recovery"],
  "next_review_window_days": 21,
  "confidence_score": 80,
  "summary": "Optimal hypertrophy dose with manageable fatigue profile.",
  "language": "en",
  "_enterprise": {"client": "Acme Health", "plan": "pro", "request_id": "ef35d53f9622ec8a", "quota": 120, "usage_tracking": true},
  "_api_metadata_": {"endpoint_name": "fitness_volume_load_analysis", "response_language": "en"}
}

Posicionamiento del producto

Diseñado para productos de análisis de fuerza, herramientas para entrenadores y paneles de rendimiento.

Nota

muscle_group debe coincidir con el conjunto de enumeraciones admitido.

Endpoints recomendados