Aller au contenu

Prévision de la Récomposition du Corps

Estimer la trajectoire attendue de perte de graisse vs. prise de muscle et la probabilité de réussite de la récomposition, incluant des blocs de projection de 4/8/12 semaines.

Point de terminaison

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

Paramètres

Nom Type Obligatoire Valeur Description
current_weight nombre (35-300) Oui Requête/Corps Poids corporel actuel en kg.
body_fat_percentage nombre (5-60) Oui Requête/Corps Pourcentage de graisse corporelle actuel.
calorie_intake nombre (800-6000) Oui Requête/Corps Apport quotidien moyen.
protein_intake nombre (40-450) Oui Requête/Corps Protéines par jour en grammes.
training_days entier (0-7) Oui Requête/Corps Nombre de jours d'entraînement en résistance par semaine.
experience_level chaîne Oui Requête/Corps beginner, intermediate, advanced, elite.
lang chaîne Non Requête Langue de la réponse (en, es, de, fr, pt, ja, hi, ar).

Pourquoi Utiliser ce Point de Terminaison

  • Transformer les données d'apport/entraînement statiques en résultats de récomposition prévus.
  • Prioriser les utilisateurs en fonction de la probabilité de récomposition pour les interventions de coaching.
  • Offrir une visibilité temporelle pour améliorer l'adhérence et la rétention.

Commencer

Exemple de Requête

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"
  }'

Exemple de Réponse

Info

L'exemple de réponse ci-dessous est uniquement à des fins de démonstration. Pour obtenir la structure JSON complète, en temps réel et potentiellement plus riche, effectuez une requête sur cet 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"
  }
}

Positionnement sur le Marché

Excellent pour les plateformes de coaching de haute fidélité et les produits de remise en forme premium où les utilisateurs ont besoin de prévisions de progrès basées sur des probabilités.

Note

La validation est stricte pour tous les paramètres de plage (poids, graisse corporelle, calories, protéines et jours d'entraînement).

Points de terminaison Recommandés