Analyse de l'état hebdomadaire via API¶
Transformez les signaux hebdomadaires de poids, de force, de récupération et d'observance en décisions de progression actionnables.
Point de terminaison¶
GET /api/v1/fitness/weekly-checkin-analysisPOST /api/v1/fitness/weekly-checkin-analysis/post
Paramètres¶
| Nom | Type | Obligatoire | Valeur | Description |
|---|---|---|---|---|
weight_change | nombre (-10 à 10) | Oui | Requête/Corps | Variation du poids hebdomadaire en kg. |
strength_change | nombre (-30 à 30) | Oui | Requête/Corps | Variation du pourcentage de force hebdomadaire. |
recovery_score_avg | nombre (0-100) | Oui | Requête/Corps | Score de récupération moyen. |
calorie_adherence_percent | nombre (0-150) | Oui | Requête/Corps | Pourcentage de respect des recommandations nutritionnelles. |
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¶
- Standardiser les décisions de suivi hebdomadaire à grande échelle.
- Identifier automatiquement les situations nécessitant une intervention.
- Améliorer la cohérence de l'entraînement grâce au système de notation de l'élan.
Exemple de requête¶
curl -X GET "https://api.hefitapi.com/api/v1/fitness/weekly-checkin-analysis?weight_change=-0.6&strength_change=1.8&recovery_score_avg=71&calorie_adherence_percent=88&lang=en" \
-H "X-API-Key: YOUR_API_KEY"
curl -X POST "https://api.hefitapi.com/api/v1/fitness/weekly-checkin-analysis/post?lang=en" \
-H "Content-Type: application/json" \
-H "X-API-Key: YOUR_API_KEY" \
-d '{"weight_change":-1.3,"strength_change":-2.4,"recovery_score_avg":54,"calorie_adherence_percent":72}'
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.
{
"weight_change_kg": -0.6,
"strength_change_percent": 1.8,
"recovery_score_avg": 71.0,
"calorie_adherence_percent": 88.0,
"progress_interpretation": {"status": "on_track", "status_label": "On Track", "insight": "Current trend supports target progress."},
"adjustment_recommendations": ["Maintain current structure and monitor consistency"],
"weekly_priority_protocol": {"focus": "execution consistency"},
"next_week_focus": ["Preserve recovery and progressive overload"],
"intervention_matrix_flags": [],
"review_schedule": {"next_checkin_days": 7},
"momentum_rating": {"score": 83, "rating": "high", "rating_label": "High", "summary": "Momentum is strong and stable."},
"language": "en",
"_enterprise": {"client": "Acme Health", "plan": "pro", "request_id": "f359506a436d1e2d", "quota": 120, "usage_tracking": true},
"_api_metadata_": {"endpoint_name": "fitness_weekly_checkin_analysis", "response_language": "en"}
}
Positionnement du produit¶
Idéal pour les séances de coaching, le suivi des habitudes et la surveillance des performances de l'entreprise.
Note
calorie_adherence_percent permet des valeurs supérieures à 100 pour représenter une observance/conformité excessive.
Points de terminaison recommandés¶
GET /api/v1/fitness/volume-load-analysis- API d'analyse de la charge volumiqueGET /api/v1/fitness/weekly-plan- API du plan hebdomadaireGET /api/v1/bmi- API du BMIGET /api/v1/tdee- API du TDEEGET /api/v1/bmr- API du BMRGET /api/v1/protein-calculator- API du calculateur de protéines