Aller au contenu

API de suivi de la récupération musculaire

Calculez le moment optimal pour entraîner un groupe musculaire en fonction de la charge de travail, de l'âge de l'entraînement, de la consommation de protéines et de la récupération par sommeil.

Point de terminaison

  • GET /api/v1/fitness/muscle-recovery-timeline
  • POST /api/v1/fitness/muscle-recovery-timeline/post

Paramètres

Nom Type Obligatoire Valeur Description
muscle_group chaîne Oui Requête/Corps chest, back, legs, shoulders, arms, core, glutes, calves, full_body.
workout_intensity chaîne Oui Requête/Corps low, moderate, high, very_high, maximal.
total_sets entier (1-60) Oui Requête/Corps Nombre de séries de travail effectuées pour la séance.
training_age_years nombre (0-40) Oui Requête/Corps Expérience de l'entraînement en années.
protein_intake nombre (30-450) Oui Requête/Corps Apport quotidien en protéines en grammes.
sleep_hours nombre (0-16) Oui Requête/Corps Durée du sommeil.
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

  • Éliminez les incertitudes concernant le moment de la reprise d'entraînement.
  • Quantifiez le risque de sur-entraînement lors de la reprise précoce.
  • Fournissez des recommandations immédiates pour la récupération active.

Commencer

Exemple de requête

curl -X GET "https://api.hefitapi.com/api/v1/fitness/muscle-recovery-timeline?muscle_group=legs&workout_intensity=high&total_sets=18&training_age_years=4&protein_intake=160&sleep_hours=6.8&lang=en" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.hefitapi.com/api/v1/fitness/muscle-recovery-timeline/post?lang=en" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"muscle_group":"chest","workout_intensity":"very_high","total_sets":16,"training_age_years":2,"protein_intake":130,"sleep_hours":7.2}'

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 à cet endpoint.

{
  "muscle_group": "legs",
  "muscle_group_label": "Legs",
  "workout_intensity": "high",
  "workout_intensity_label": "High",
  "total_sets": 18,
  "training_age_years": 4.0,
  "protein_intake_g": 160.0,
  "sleep_hours": 6.8,
  "estimated_recovery_time_hours": 90,
  "optimal_retraining_window_hours": {"start": 84, "end": 108, "insight": "Allow full tissue recovery before repeat loading."},
  "overtraining_risk_if_trained_earlier": {"risk_score": 79, "risk_level": "very_high", "risk_label": "Very High", "insight": "Early retraining likely to reduce output and recovery."},
  "suggested_active_recovery_strategy": ["Low-intensity movement and mobility work"],
  "fatigue_carryover_warning": {"level": "severe", "level_label": "Severe", "warning": "High carryover fatigue risk from current session load."},
  "confidence_score": 73,
  "confidence_label": "Moderate",
  "recovery_driver_breakdown": {
    "base_hours": 72.0,
    "intensity_adjustment": 8.0,
    "set_volume_adjustment": 10.8,
    "training_age_adjustment": 0.0,
    "protein_adjustment": -2.0,
    "sleep_adjustment": 6.0
  },
  "summary": "Extended recovery window recommended before heavy retraining.",
  "language": "en",
  "_enterprise": {"client": "Acme Health", "plan": "pro", "request_id": "0a26e0765f73ff84", "quota": 120, "usage_tracking": true},
  "_api_metadata_": {"endpoint_name": "fitness_muscle_recovery_timeline", "response_language": "en"}
}

Positionnement du produit

Conçu pour les coachs de haut niveau, l'automatisation de la récupération et les programmes d'entraînement à haute fréquence.

Note

total_sets prend en charge 1-60; les valeurs en dehors de cette plage renvoient une erreur HTTP 400.

Points de terminaison recommandés