API de charge d'entraînement adaptative¶
Retournez une décision d'entraînement consciente de la préparation (push, maintain, pull_back) avec delta d'intensité, ajustement du volume, déplacement de blessure et score de confiance.
Point de terminaison¶
GET /api/v1/fitness/adaptive-training-loadPOST /api/v1/fitness/adaptive-training-load/post
Paramètres¶
| Nom | Type | Obligatoire | In | Description |
|---|---|---|---|---|
planned_intensity | nombre (1-10) | Oui | Requête/Corps | Intensité planifiée de la séance. |
recovery_score | nombre (0-100) | Oui | Requête/Corps | Score de récupération global. |
sleep_hours | nombre (0-16) | Oui | Requête/Corps | Durée du sommeil de la nuit précédente. |
hrv | nombre (10-200) | Oui | Requête/Corps | HRV utilisé pour la notation de la préparation. |
muscle_soreness | nombre (0-10) | Oui | Requête/Corps | Évaluation subjective de la douleur. |
goal | chaîne | Oui | Requête/Corps | fat_loss, muscle_gain, performance, maintenance, recomposition. |
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¶
- Fournir une auto-régulation en tant que service pour les applications d'entraînement.
- Réduire le risque de surentraînement grâce aux entrées objectives et subjectives de préparation.
- Fournir des ajustements de séance explicables aux athlètes et aux entraîneurs.
Exemple de requête¶
curl -X GET "https://api.hefitapi.com/api/v1/fitness/adaptive-training-load?planned_intensity=7&recovery_score=74&sleep_hours=7.2&hrv=58&muscle_soreness=4&goal=performance&lang=en" \
-H "X-API-Key: YOUR_API_KEY"
curl -X POST "https://api.hefitapi.com/api/v1/fitness/adaptive-training-load/post?lang=en" \
-H "Content-Type: application/json" \
-H "X-API-Key: YOUR_API_KEY" \
-d '{
"planned_intensity": 7,
"recovery_score": 74,
"sleep_hours": 7.2,
"hrv": 58,
"muscle_soreness": 4,
"goal": "performance"
}'
Exemple de réponse¶
Info
L'exemple de réponse ci-dessous est uniquement à des fins de démonstration. Pour recevoir la structure JSON complète, en temps réel et potentiellement plus riche, effectuez une requête en direct vers cet endpoint.
{
"planned_intensity": 7.0,
"adjusted_training_intensity_recommendation": 7.9,
"adjusted_training_intensity_delta": 0.9,
"volume_adjustment_percent": 8,
"decision": "push",
"decision_label": "Push",
"injury_probability_shift_percent_points": -1.8,
"performance_optimization_note": "Readiness supports a progressive session.",
"confidence_score": 87,
"confidence_label": "High",
"goal": "performance",
"goal_label": "Performance",
"readiness_signals": {
"recovery_score": 74.0,
"sleep_hours": 7.2,
"hrv": 58.0,
"muscle_soreness": 4.0,
"composite_readiness_score": 75.8
},
"recommended_action_blocks": [
"Increase load slightly on primary lift.",
"Keep movement quality high across sets."
],
"summary": "Train hard with quality control.",
"language": "en",
"_enterprise": {
"client": "Acme Health",
"plan": "pro",
"request_id": "35ce4816f312aa0b",
"quota": 120,
"usage_tracking": true
},
"_api_metadata_": {
"api_name": "Health Fitness API by Dakidarts®",
"endpoint_name": "fitness_adaptive_training_load",
"response_language": "en"
}
}
Adéquation au marché¶
Idéal pour le coaching de premier ordre, le suivi des athlètes et les produits de programmation adaptative où les décisions d'entraînement quotidiennes influencent la rétention et les résultats.
Note
La validation impose des plages strictes pour l'intensité, le score de récupération, le HRV, le sommeil et la douleur.
Points de terminaison recommandés¶
GET /api/v1/fitness/cortisol-stress-load- API de charge de stress cortisolGET /api/v1/fitness/fasted-training-risk- API de risque d'entraînement au jeûneGET /api/v1/fitness/training-archetype- API d'archetype d'entraînementGET /api/v1/fitness/volume-load-analysis- API d'analyse de charge de volumeGET /api/v1/bmi- API BMIGET /api/v1/tdee- API TDEE