نطاقات معدل ضربات القلب¶
إرجاع نطاقات احتياطي معدل ضربات القلب مع سياق تدريبي عملي لفقدان الدهون، وتحسين التحمل والأداء.
نقطة النهاية¶
GET /api/v1/fitness/heart-rate-zonesPOST /api/v1/fitness/heart-rate-zones/post
المعلمات¶
| الاسم | النوع | مطلوب | In | الوصف |
|---|---|---|---|---|
age | عدد صحيح (13-90) | نعم | استعلام/جسم | عمر الرياضي بالسنوات. |
resting_hr | رقم (30-130) | نعم | استعلام/جسم | معدل ضربات القلب أثناء الراحة (بالنبضات في الدقيقة). |
goal | سلسلة | نعم | استعلام/جسم | fat_loss,muscle_gain,maintenance,endurance,recomposition. |
max_hr | رقم (120-230) | لا | استعلام/جسم | الحد الأقصى لمعدل ضربات القلب؛ إذا تم حذفه، يتم استخدام تقدير يعتمد على العمر. |
lang | سلسلة | لا | استعلام | لغة الاستجابة (en,es,de,fr,pt,ja,hi,ar). |
لماذا استخدام هذه نقطة النهاية¶
- تقديم نطاقات معدل ضربات القلب الجاهزة للتدريب لكل ملف تعريف مستخدم.
- محاذاة تعليمات التدريب مع الأهداف والجاهزية.
- دعم الأتمتة التدريبية باستخدام منطق نطاق متسق.
مثال على الطلب¶
curl -X GET "https://api.hefitapi.com/api/v1/fitness/heart-rate-zones?age=33&resting_hr=58&goal=endurance&lang=en" \
-H "X-API-Key: YOUR_API_KEY"
curl -X POST "https://api.hefitapi.com/api/v1/fitness/heart-rate-zones/post?lang=en" \
-H "Content-Type: application/json" \
-H "X-API-Key: YOUR_API_KEY" \
-d '{"age":33,"resting_hr":58,"goal":"fat_loss","max_hr":188}'
مثال على الاستجابة¶
معلومات
مثال الاستجابة أدناه لأغراض العرض التوضيحي فقط. للحصول على هيكل JSON الكامل والفعل الفعلي في الوقت الفعلي، قم بإرسال طلب إلى هذه نقطة النهاية.
{
"goal": "fat_loss",
"goal_label": "Fat Loss",
"age": 33,
"resting_hr_bpm": 58.0,
"max_hr_bpm": 188,
"max_hr_source": "provided",
"heart_rate_reserve_bpm": 130,
"zones": {
"zone_1": {"label": "Zone 1", "min_bpm": 123, "max_bpm": 136},
"zone_2": {"label": "Zone 2", "min_bpm": 136, "max_bpm": 149},
"zone_3": {"label": "Zone 3", "min_bpm": 149, "max_bpm": 162},
"zone_4": {"label": "Zone 4", "min_bpm": 162, "max_bpm": 175},
"zone_5": {"label": "Zone 5", "min_bpm": 175, "max_bpm": 188}
},
"fat_burn_zone": {"zone": "zone_2", "label": "Fat Burn Zone", "min_bpm": 136, "max_bpm": 149},
"vo2_optimization_zone": {"zone": "zone_4", "label": "VO2 Optimization Zone", "min_bpm": 162, "max_bpm": 175},
"threshold_zone": {"zone": "zone_4", "min_bpm": 162, "max_bpm": 175},
"anaerobic_power_zone": {"zone": "zone_5", "min_bpm": 175, "max_bpm": 188},
"readiness_signal": {"level": "high", "level_label": "High", "note": "Recovery indicators support quality intervals."},
"goal_session_guidance": ["2 threshold intervals", "1 long zone-2 block"],
"training_notes": {
"warmup": "Build progressively for 10-15 minutes.",
"cooldown": "Use 8-10 minutes low-intensity recovery.",
"zone_switching": "Transition gradually when moving between zones."
},
"summary": "Balanced zone strategy optimized for fat-loss efficiency.",
"language": "en",
"_enterprise": {
"client": "Acme Health",
"plan": "pro",
"request_id": "f6b9fb31d4f2a027",
"quota": 120,
"usage_tracking": true
},
"_api_metadata_": {
"endpoint_name": "fitness_heart_rate_zones",
"response_language": "en"
}
}
وضع المنتج¶
مثالي لأجهزة اللياقة البدنية المتصلة ولوحات التحكم التدريبية وأتمتة التدريب التحملي.
ملاحظة
max_hr اختياري. إذا تم حذفه، يقوم API بتقدير الحد الأقصى لمعدل ضربات القلب من العمر باستخدام صيغة تانكا.
نقاط النهاية الموصى بها¶
GET /api/v1/bmi- واجهة برمجة تطبيقات BMIGET /api/v1/tdee- واجهة برمجة تطبيقات TDEEGET /api/v1/bmr- واجهة برمجة تطبيقات BMRGET /api/v1/protein-calculator- واجهة برمجة تطبيقات حاسبة البروتينGET /api/v1/bodyfat- واجهة برمجة تطبيقات نسبة الدهون في الجسمGET /api/v1/maintenance-calorie- واجهة برمجة تطبيقات السعرات الحرارية للحفاظ على الوزن