Aller au contenu

API d'estimation du VO2max

Créez des profils de condition cardiorespiratoire à partir des performances des tests et de la physiologie au repos.

Point de terminaison

  • GET /api/v1/fitness/vo2max-estimate
  • POST /api/v1/fitness/vo2max-estimate/post

Paramètres

Nom Type Obligatoire Valeur Description
age entier (13-85) Oui Requête/Corps Âge en années.
gender chaîne Oui Requête/Corps male ou female.
resting_hr nombre (30-130) Oui Requête/Corps Fréquence cardiaque au repos en bpm.
cooper_test_distance nombre (800-5000) Conditionnel Requête/Corps Distance du test Cooper de 12 minutes en mètres.
1_5_mile_time nombre (6-30) Conditionnel Requête/Corps Temps de course de 1,5 miles en minutes.
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

  • Combinez plusieurs méthodes d'estimation du VO2max dans une seule réponse.
  • Ajoutez des fonctionnalités de classification, de percentile et de guidage de l'entraînement.
  • Prenez en charge les fonctionnalités d'âge de la condition physique et d'évaluation des risques.

Commencer

Exemple de requête

curl -X GET "https://api.hefitapi.com/api/v1/fitness/vo2max-estimate?age=33&gender=male&resting_hr=56&cooper_test_distance=2800&lang=en" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.hefitapi.com/api/v1/fitness/vo2max-estimate/post?lang=en" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"age":29,"gender":"female","resting_hr":60,"1_5_mile_time":11.8}'

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.

{
  "age": 33,
  "gender": "male",
  "resting_hr_bpm": 56.0,
  "test_inputs": {"cooper_test_distance_m": 2800.0, "run_1_5_mile_time_min": null},
  "estimate_method": "cooper_blend",
  "estimate_method_label": "Cooper Blend",
  "vo2max_estimate_ml_kg_min": 51.2,
  "vo2max_range_ml_kg_min": {"lower": 45.1, "upper": 57.3},
  "fitness_classification": "excellent",
  "fitness_classification_label": "Excellent",
  "percentile_estimate": 87,
  "confidence": {"score": 84, "level": "medium", "level_label": "Medium", "notes": "Single-test blend provides solid directional estimate."},
  "cardiorespiratory_risk_insight": "Favorable cardiorespiratory profile.",
  "training_focus_recommendations": ["Maintain aerobic base and threshold progressions"],
  "derived_metrics": {"estimated_hr_max_bpm": 185, "hr_reserve_bpm": 129, "fitness_age_estimate_years": 28},
  "summary": "Excellent aerobic profile with strong performance potential.",
  "language": "en",
  "_enterprise": {"client": "Acme Health", "plan": "pro", "request_id": "31a83dfecbe5a34b", "quota": 120, "usage_tracking": true},
  "_api_metadata_": {"endpoint_name": "fitness_vo2max_estimate", "response_language": "en"}
}

Positionnement du produit

Un point de terminaison de haute valeur pour les applications d'endurance, les systèmes de notation de la santé et les plateformes de diagnostic de l'entraînement.

Note

Fournissez au moins un champ de test : cooper_test_distance ou 1_5_mile_time.

Points de terminaison recommandés