Aller au contenu

API pour la définition des objectifs de progression

Générez un calendrier de progression par phases pour atteindre des objectifs de perte de poids, de prise de masse, de maintien ou de récomposition.

Point de terminaison

  • GET /api/v1/fitness/progression-targets
  • POST /api/v1/fitness/progression-targets/post

Paramètres

Nom Type Obligatoire In Description
goal chaîne de caractères Oui Requête/Corps fat_loss, muscle_gain, maintenance, endurance, recomposition.
current_weight nombre (35-300) Oui Requête/Corps Poids corporel actuel en kg.
time_horizon_weeks entier (2-52) Oui Requête/Corps Période cible en semaines.
lang chaîne de caractères Non Requête Langue de la réponse (en, es, de, fr, pt, ja, hi, ar).

Pourquoi utiliser cet endpoint

  • Définir des objectifs hebdomadaires réalistes à partir d'une logique de progression sûre.
  • Retourner les limites minimales et maximales pour un contrôle des risques.
  • Faciliter les flux de contrôle avec des règles de correction claires.

Commencer

Exemple de requête

curl -X GET "https://api.hefitapi.com/api/v1/fitness/progression-targets?goal=recomposition&current_weight=82&time_horizon_weeks=12&lang=en" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.hefitapi.com/api/v1/fitness/progression-targets/post?lang=en" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"goal":"fat_loss","current_weight":91,"time_horizon_weeks":16}'

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 réelle vers cet endpoint.

{
  "goal": "recomposition",
  "goal_label": "Recomposition",
  "current_weight_kg": 82.0,
  "time_horizon_weeks": 12,
  "weekly_target_change_kg": -0.12,
  "safe_progression_bounds": {
    "weekly_change_kg_min": -0.33,
    "weekly_change_kg_max": 0.08,
    "total_change_kg_min": -3.94,
    "total_change_kg_max": 0.98
  },
  "weekly_targets": [
    {"week": 1, "target_weight_kg": 81.88, "change_from_start_kg": -0.12},
    {"week": 2, "target_weight_kg": 81.75, "change_from_start_kg": -0.25}
  ],
  "weekly_execution_targets": ["Hold protein and progressive training consistency"],
  "course_correction_triggers": ["Adjust intake if trend diverges for 2 consecutive weeks"],
  "compliance_scorecard": ["Track adherence to training, sleep, and nutrition"],
  "review_schedule": {"weekly": "trend review", "monthly": "strategy adjustment"},
  "summary": "Gradual progression target supports sustainable recomposition.",
  "adjustment_logic": "Use small weekly adjustments while preserving performance.",
  "safety_note": "Avoid aggressive shifts outside safe progression bounds.",
  "language": "en",
  "_enterprise": {"client": "Acme Health", "plan": "pro", "request_id": "5df3ca7f3f4bad5e", "quota": 120, "usage_tracking": true},
  "_api_metadata_": {"endpoint_name": "fitness_progression_targets", "response_language": "en"}
}

Positionnement du produit

Conçu pour les plateformes de coaching, les applications de transformation corporelle et les tableaux de bord d'analyse des progrès.

Note

time_horizon_weeks doit se situer entre 2 et 52.

Endpoints recommandés