Saltar a contenido

Predicción de Recomposición Corporal API

Estima la trayectoria esperada de pérdida de grasa vs. ganancia muscular y la probabilidad de una recomposición exitosa, incluyendo bloques de proyección de 4/8/12 semanas.

Endpoint

  • GET /api/v1/fitness/body-recomp-forecast
  • POST /api/v1/fitness/body-recomp-forecast/post

Parámetros

Nombre Tipo Obligatorio In Descripción
current_weight número (35-300) Sí Consulta/Cuerpo Peso corporal actual en kg.
body_fat_percentage número (5-60) Sí Consulta/Cuerpo Porcentaje de grasa corporal actual.
calorie_intake número (800-6000) Sí Consulta/Cuerpo Consumo diario promedio.
protein_intake número (40-450) Sí Consulta/Cuerpo Proteína diaria en gramos.
training_days entero (0-7) Sí Consulta/Cuerpo Días de entrenamiento de resistencia por semana.
experience_level cadena Sí Consulta/Cuerpo beginner, intermediate, advanced, elite.
lang cadena No Consulta Idioma de la respuesta (en, es, de, fr, pt, ja, hi, ar).

¿Por qué usar este Endpoint?

  • Convierte los datos estáticos de ingesta/entrenamiento en resultados de recomposición proyectados.
  • Prioriza a los usuarios según la probabilidad de recomposición para intervenciones de coaching.
  • Ofrece visibilidad del tiempo para mejorar la adherencia y la retención.

Empezar

Ejemplo de Solicitud

curl -X GET "https://api.hefitapi.com/api/v1/fitness/body-recomp-forecast?current_weight=84&body_fat_percentage=24&calorie_intake=2350&protein_intake=165&training_days=4&experience_level=intermediate&lang=en" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.hefitapi.com/api/v1/fitness/body-recomp-forecast/post?lang=en" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
    "current_weight": 84,
    "body_fat_percentage": 24,
    "calorie_intake": 2350,
    "protein_intake": 165,
    "training_days": 4,
    "experience_level": "intermediate"
  }'

Ejemplo de Respuesta

Info

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

{
  "current_weight_kg": 84.0,
  "body_fat_percentage": 24.0,
  "calorie_intake": 2350,
  "protein_intake_g": 165.0,
  "training_days": 4,
  "experience_level": "intermediate",
  "experience_level_label": "Intermediate",
  "estimated_fat_loss_vs_muscle_gain_ratio": {
    "fat_loss_kg_per_week": 0.23,
    "muscle_gain_kg_per_week": 0.13,
    "fat_to_muscle_ratio": 1.77,
    "ratio_label": "balanced_recomp",
    "ratio_label_text": "Balanced recomp"
  },
  "recomp_probability_score": {
    "score": 73,
    "band": "moderate",
    "band_label": "Moderate",
    "insight": "Good potential with consistency."
  },
  "timeline_projection": [
    {
      "week": 4,
      "projected_weight_kg": 83.6,
      "projected_body_fat_percent": 23.2,
      "estimated_fat_mass_change_kg": -0.92,
      "estimated_lean_mass_change_kg": 0.52
    }
  ],
  "strategy_adjustment_advice": ["Keep protein high", "Maintain progressive overload"],
  "metabolic_context": {
    "estimated_maintenance_calories": 2720,
    "daily_energy_gap": -370,
    "protein_g_per_kg": 1.96
  },
  "confidence_score": 84,
  "summary": "Consistent execution can deliver measurable recomposition.",
  "language": "en",
  "_enterprise": {
    "client": "Acme Health",
    "plan": "pro",
    "request_id": "4b2ad1f68d3dc50a",
    "quota": 120,
    "usage_tracking": true
  },
  "_api_metadata_": {
    "api_name": "Health Fitness API by Dakidarts®",
    "endpoint_name": "fitness_body_recomp_forecast",
    "response_language": "en"
  }
}

Posicionamiento en el Mercado

Excelente para plataformas de coaching de alta participación y productos de fitness premium donde los usuarios necesitan una previsión de progreso basada en la probabilidad.

Nota

La validación es estricta para todas las entradas con rangos definidos (peso, grasa corporal, calorías, proteína y días de entrenamiento).

Endpoints Recomendados