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

تشغيل واجهة برمجة تطبيقات الجري

قياس كفاءة الجري وإرجاع الأدوات التدريبية التي تحسن نتائج السرعة لكل جهد.

نقطة النهاية

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

المعلمات

الاسم النوع مطلوب In الوصف
pace_per_km رقم (2.0-15.0) نعم استعلام/جسم متوسط السرعة لكل كيلومتر (دقائق).
heart_rate_avg رقم (80-210) نعم استعلام/جسم متوسط معدل ضربات القلب (نبضات في الدقيقة).
vo2max رقم (15-90) نعم استعلام/جسم تقدير/قيمة أقصى VO2.
body_weight رقم (35-250) نعم استعلام/جسم وزن الجسم بالكيلوغرام.
lang سلسلة لا استعلام لغة الاستجابة (en,es,de,fr,pt,ja,hi,ar).

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

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

ابدأ الآن

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

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

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

معلومات

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

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

وضع المنتج

ميزة متميزة لتحليلات التحمل وتطبيقات التدريب ومنتجات أداء السباق.

ملاحظة

يتوقع pace_per_km تنسيق الدقائق لكل كيلومتر، وليس السرعة بالكيلومترات في الساعة.

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