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

نطاقات معدل ضربات القلب

إرجاع نطاقات احتياطي معدل ضربات القلب مع سياق تدريبي عملي لفقدان الدهون، وتحسين التحمل والأداء.

نقطة النهاية

  • GET /api/v1/fitness/heart-rate-zones
  • POST /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 بتقدير الحد الأقصى لمعدل ضربات القلب من العمر باستخدام صيغة تانكا.

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