انتقل إلى المحتوى

واجهة برمجة تطبيقات تقدير VO2max

إنشاء ملفات تعريف لياقة القلب والأوعية الدموية بناءً على أداء الاختبارات الميدانية والفسيولوجيا في حالة الراحة.

نقطة النهاية

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

المعلمات

الاسم النوع مطلوب في الوصف
age عدد صحيح (13-85) نعم استعلام/جسم العمر بالسنوات.
gender سلسلة نعم استعلام/جسم male أو female.
resting_hr رقم (30-130) نعم استعلام/جسم معدل ضربات القلب في حالة الراحة (نبضة في الدقيقة).
cooper_test_distance رقم (800-5000) اختياري استعلام/جسم مسافة 12 دقيقة من اختبار كوبر بالمتر.
1_5_mile_time رقم (6-30) اختياري استعلام/جسم وقت الجري لمسافة 1.5 ميل بالدقائق.
lang سلسلة لا استعلام لغة الاستجابة (en,es,de,fr,pt,ja,hi,ar).

لماذا استخدام هذه نقطة النهاية

  • الجمع بين طرق متعددة لتقدير VO2max في استجابة واحدة.
  • إضافة إرشادات التصنيف، والنسب المئوية، والتركيز على التدريب.
  • دعم ميزات لياقة العمر والرؤى المتعلقة بالمخاطر.

ابدأ الآن

مثال على الطلب

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}'

مثال على الاستجابة

معلومات

مثال الاستجابة أدناه مخصص للأغراض التوضيحية فقط. للحصول على الاستجابة الكاملة والواقعية وفي الوقت الفعلي، قد يكون هناك أيضًا هيكل JSON أكثر ثراءً، قم بإرسال طلب مباشر إلى هذه نقطة النهاية.

{
  "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"}
}

تحديد المنتج

نقطة نهاية ذات قيمة عالية لتطبيقات التحمل، وقياس اللياقة، ومنصات التشخيص التدريبي.

ملاحظة

توفير مدخل واحد على الأقل للاختبار الميداني: cooper_test_distance أو 1_5_mile_time.

نقاط النهاية الموصى بها