Aller au contenu

API d'évaluation de la performance de course

Quantifiez l'efficacité de la course et obtenez des leviers d'entraînement pour améliorer les résultats en termes de vitesse par effort.

Point de terminaison

  • GET /api/v1/fitness/running-economy
  • POST /api/v1/fitness/running-economy/post

Paramètres

Nom Type Obligatoire Valeur Description
pace_per_km nombre (2,0-15,0) Oui Requête/Corps Vitesse moyenne par kilomètre (minutes).
heart_rate_avg nombre (80-210) Oui Requête/Corps Fréquence cardiaque moyenne en battements par minute.
vo2max nombre (15-90) Oui Requête/Corps Estimation/Valeur de la consommation maximale d'oxygène.
body_weight nombre (35-250) Oui Requête/Corps Poids corporel en kg.
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 de course en un seul indicateur de performance clair.
  • Comparer les performances grâce aux percentiles et aux plages.
  • Obtenir des suggestions pratiques pour l'amélioration.

Commencer

Exemple de requête

curl -X GET "https://api.hefitapi.com/api/v1/fitness/running-economy?pace_per_km=4.9&heart_rate_avg=162&vo2max=51&body_weight=73&lang=en" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.hefitapi.com/api/v1/fitness/running-economy/post?lang=en" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"pace_per_km":5.6,"heart_rate_avg":171,"vo2max":45,"body_weight":80}'

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.

{
  "pace_per_km": 4.9,
  "heart_rate_avg_bpm": 162.0,
  "vo2max_ml_kg_min": 51.0,
  "body_weight_kg": 73.0,
  "running_efficiency_score": 79,
  "efficiency_band": {"band": "strong", "band_label": "Strong", "insight": "Strong economy profile with room for refinement."},
  "economy_percentile": 79,
  "economy_index": 33.2,
  "efficiency_components": {"pace_component": 41.4, "heart_rate_component": 15.4, "aerobic_component": 39.0, "mass_penalty": 2.9},
  "improvement_lever_suggestions": ["Use threshold intervals and aerobic volume consistency"],
  "stimulus_focus": "Threshold + aerobic durability",
  "confidence_score": 87,
  "summary": "Running economy is strong with targeted gains available.",
  "language": "en",
  "_enterprise": {"client": "Acme Health", "plan": "pro", "request_id": "93027cd0f866757d", "quota": 120, "usage_tracking": true},
  "_api_metadata_": {"endpoint_name": "fitness_running_economy", "response_language": "en"}
}

Positionnement du produit

Une fonctionnalité différenciée pour l'analyse de la performance de l'endurance, les applications de formation et les produits de performance sportive.

Note

pace_per_km attend le format minutes par kilomètre, et non la vitesse en km/h.

Points de terminaison recommandés