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

واجهة برمجة تطبيقات كارفونين

توفر إرشادات دقيقة لوضع معدل ضربات القلب المستهدف للجلسات القلبية مع التحكم في شدة تعتمد على النطاق.

نقطة النهاية

  • GET /api/v1/karvonen
  • POST /api/v1/karvonen/post

المعلمات

الاسم النوع مطلوب في الوصف
age عدد صحيح (>0) نعم استعلام/جسم العمر بالسنوات.
rhr عدد صحيح (>0) نعم استعلام/جسم معدل ضربات القلب أثناء الراحة بـ bpm.
intensity رقم (10-100) نعم استعلام/جسم النسبة المئوية للشدة المستهدفة للتمارين.
mhr عدد صحيح (>0) لا استعلام/جسم الحد الأقصى لـ HR؛ إذا تم حذفه، تستخدم واجهة برمجة التطبيقات 220 - age.
lang سلسلة لا استعلام لغة الاستجابة (en,es,de,fr,pt,ja,hi,ar).

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

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

ابدأ الآن

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

curl -X GET "https://api.hefitapi.com/api/v1/karvonen?age=35&rhr=58&intensity=72&lang=en" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.hefitapi.com/api/v1/karvonen/post?lang=en" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"age":35,"rhr":58,"mhr":188,"intensity":78}'

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

معلومات

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

{
  "age": 35,
  "resting_heart_rate_bpm": 58,
  "maximum_heart_rate_bpm": 185,
  "used_default_max_hr": true,
  "heart_rate_reserve_bpm": 127,
  "intensity_percent": 72.0,
  "target_heart_rate_bpm": 149.44,
  "training_zone_range_bpm": {
    "min": 143.09,
    "max": 155.79
  },
  "intensity_band": "aerobic",
  "intensity_band_label": "Aerobic",
  "risk_signal": "Sustainable zone for base-building sessions.",
  "action_plan": ["Use longer steady-state intervals"],
  "monitoring_plan": "Track drift and perceived exertion each session.",
  "_enterprise": {
    "client": "Acme Health",
    "plan": "pro",
    "request_id": "dd67b47d2223915c",
    "quota": 120,
    "usage_tracking": true
  },
  "_api_metadata_": {
    "endpoint_name": "karvonen",
    "response_language": "en"
  }
}

وضع المنتج

ممتاز لتطبيقات التحمل ولوحات التحكم والمنصات الرياضية التي تتطلب أتمتة مستهدفة للـ BPM القابلة للتكرار.

ملاحظة

إذا تم حذف mhr، فإن الحد الأقصى لـ HR سيتم تعيينه افتراضيًا إلى 220 - age.

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