واجهة برمجة تطبيقات (API) لتقييم طول العمر¶
حوّل الإشارات الحيوية اليومية وأسلوب الحياة إلى درجة تقييم واقعية لطول العمر مع أولويات تحسين منظمة.
نقطة النهاية¶
GET /api/v1/fitness/longevity-scorePOST /api/v1/fitness/longevity-score/post
المعلمات¶
| الاسم | النوع | مطلوب | في | الوصف |
|---|---|---|---|---|
resting_hr | رقم (30-120) | نعم | استعلام/جسم | معدل ضربات القلب أثناء الراحة (نبضة في الدقيقة). |
vo2max | رقم (10-90) | نعم | استعلام/جسم | تقدير/قيمة أقصى معدل الأكسجين. |
body_fat_percentage | رقم (3-60) | نعم | استعلام/جسم | نسبة الدهون في الجسم. |
sleep_hours | رقم (0-16) | نعم | استعلام/جسم | متوسط ساعات النوم. |
weekly_activity_minutes | عدد صحيح (0-2000) | نعم | استعلام/جسم | إجمالي الدقائق النشطة في الأسبوع. |
lang | سلسلة | لا | استعلام | لغة الاستجابة (en, es, de, fr, pt, ja, hi, ar). |
لماذا تستخدم هذه نقطة النهاية¶
- دمج تقييم طول العمر والمخاطر الكارديوميتابية في مخرج واحد.
- إرجاع الأهداف التشغيلية وأولويات الامتثال.
- تمكين الأتمتة في مجال التدريب أو الرعاية الوقائية على نطاق واسع.
مثال على الطلب¶
curl -X GET "https://api.hefitapi.com/api/v1/fitness/longevity-score?resting_hr=62&vo2max=42&body_fat_percentage=21&sleep_hours=7.4&weekly_activity_minutes=210&lang=en" \
-H "X-API-Key: YOUR_API_KEY"
curl -X POST "https://api.hefitapi.com/api/v1/fitness/longevity-score/post?lang=en" \
-H "Content-Type: application/json" \
-H "X-API-Key: YOUR_API_KEY" \
-d '{"resting_hr":68,"vo2max":35,"body_fat_percentage":28,"sleep_hours":6.5,"weekly_activity_minutes":160}'
مثال على الاستجابة¶
معلومات
مثال الاستجابة أدناه هو فقط لأغراض العرض التوضيحي. للحصول على بنية JSON كاملة وفي الوقت الفعلي وربما أكثر ثراء، قم بإرسال طلب حقيقي إلى هذه نقطة النهاية.
{
"longevity_score": 71,
"cardiometabolic_risk": {
"level": "low",
"level_label": "Low",
"insight": "Current profile supports favorable long-term cardiometabolic outlook."
},
"lifestyle_improvement_priorities": [
"Progress aerobic capacity with consistent zone-2 work",
"Stabilize sleep timing for recovery quality"
],
"longevity_action_plan": ["Maintain weekly movement baseline and progression"],
"quarterly_targets": ["Improve VO2max trend", "Hold resting HR within target band"],
"compliance_priorities": ["Adhere to weekly training minimum"],
"medical_escalation_flags": [],
"component_scores": {
"resting_hr_score": 62,
"vo2max_score": 63,
"body_fat_score": 97,
"sleep_score": 90,
"activity_score": 85
},
"inputs": {
"resting_hr_bpm": 62.0,
"vo2max": 42.0,
"body_fat_percentage": 21.0,
"sleep_hours": 7.4,
"weekly_activity_minutes": 210
},
"summary": "Low-risk longevity profile with targeted optimization opportunities.",
"language": "en",
"_enterprise": {
"client": "Acme Health",
"plan": "pro",
"request_id": "fe6c1f1be07d4dd2",
"quota": 120,
"usage_tracking": true
},
"_api_metadata_": {
"endpoint_name": "fitness_longevity_score",
"response_language": "en"
}
}
تحديد المنتج¶
مصمم لبرامج الصحة والرفاهية للمؤسسات، ومنصات مشاركة شركات التأمين، ومنتجات الصحة عالية الأداء.
ملاحظة
يجب أن تكون weekly_activity_minutes هي 0-2000؛ القيم التي تقع خارج النطاق تُرجع HTTP 400.
نقاط النهاية الموصى بها¶
GET /api/v1/fitness/recovery-score- واجهة برمجة تطبيقات (API) لتقييم التعافيGET /api/v1/fitness/sedentary-risk-score- واجهة برمجة تطبيقات (API) لتقييم المخاطر المتعلقة بالخمولGET /api/v1/bmi- واجهة برمجة تطبيقات (API) لـ BMIGET /api/v1/tdee- واجهة برمجة تطبيقات (API) لـ TDEEGET /api/v1/bmr- واجهة برمجة تطبيقات (API) لـ BMRGET /api/v1/protein-calculator- واجهة برمجة تطبيقات (API) لحساب البروتين