واجهة برمجة تطبيقات ABSI¶
حساب مؤشر شكل الجسم (ABSI) ودرجة Z المرجعية بناءً على العمر والجنس لتقييم اتجاهات مخاطر الوفاة المرتبطة بالسمنة المركزية.
نقطة النهاية¶
GET /api/v1/absiPOST /api/v1/absi/post
المعلمات¶
| الاسم | النوع | مطلوب | In | الوصف |
|---|---|---|---|---|
sex | سلسلة (male,female) | نعم | استعلام/جسم | الجنس البيولوجي. |
age | عدد صحيح | نعم | استعلام/جسم | العمر بالسنوات (يجب أن يكون موجودًا في جدول مرجعي لـ ABSI). |
weight | رقم | نعم | استعلام/جسم | الوزن (كيلوجرام، وحدة القياس المترية، رطل، وحدة القياس الإمبراطورية). |
height | رقم | نعم | استعلام/جسم | الطول (سنتيمتر، وحدة القياس المترية، بوصة، وحدة القياس الإمبراطورية). |
waist_circumference | رقم | نعم | استعلام/جسم | محيط الخصر (سنتيمتر، وحدة القياس المترية، بوصة، وحدة القياس الإمبراطورية). |
unit | سلسلة (metric,imperial) | لا | استعلام/جسم | وضع وحدة الإدخال. افتراضيًا metric. |
lang | سلسلة | لا | استعلام | لغة الاستجابة (en,es,de,fr,pt,ja,hi,ar). |
لماذا استخدام هذه نقطة النهاية¶
- إضافة سياق لمخاطر الوفاة بناءً على الشكل، بالإضافة إلى مؤشر كتلة الجسم (BMI) فقط.
- تخصيص محفزات التدريب باستخدام نطاقات مخاطر ABSI.
- توحيد التواصل بشأن المخاطر في تطبيقات الصحة الوقائية.
مثال على الطلب¶
curl -X GET "https://api.hefitapi.com/api/v1/absi?sex=female&age=44&weight=70&height=165&waist_circumference=82&unit=metric&lang=en" \
-H "X-API-Key: YOUR_API_KEY"
curl -X POST "https://api.hefitapi.com/api/v1/absi/post?lang=en" \
-H "Content-Type: application/json" \
-H "X-API-Key: YOUR_API_KEY" \
-d '{
"sex": "female",
"age": 44,
"weight": 70,
"height": 165,
"waist_circumference": 82,
"unit": "metric"
}'
مثال على الاستجابة¶
Info
مثال الاستجابة أدناه مخصص للأغراض التوضيحية فقط. للحصول على هيكل JSON الكامل والواقعي والذي قد يكون أكثر ثراءً، قم بإرسال طلب مباشر إلى هذه نقطة النهاية.
{
"ABSI": 0.0791,
"ABSI z-score": 0.1822,
"Mortality risk": "Average",
"Sex": "female",
"Age": 44,
"absi_value": 0.0791,
"absi_z_score": 0.1822,
"mortality_risk_band": "average",
"mortality_risk_label": "Average",
"bmi": 25.71,
"bmi_band": "elevated",
"waist_risk_status": "controlled",
"risk_signal": "Current risk profile is near expected range.",
"action_plan": ["Maintain waist control", "Keep cardio and strength balance"],
"monitoring_plan": "Re-check every 8-12 weeks.",
"language": "en",
"_enterprise": {
"client": "Acme Health",
"plan": "pro",
"request_id": "d90a2b7711de09cc",
"quota": 120,
"usage_tracking": true
},
"_api_metadata_": {
"api_name": "Health Fitness API by Dakidarts®",
"endpoint_name": "absi",
"response_language": "en"
}
}
القيمة التجارية¶
استخدم تقييم ABSI في منتجات طويلة العمر ولوحات معلومات المخاطر الصحية، ومستويات التدريب المتميزة حيث يكون توزيع الخصر مهمًا.
ملاحظة
إذا كان العمر خارج جدول مرجعي لـ ABSI، فإن نقطة النهاية ترجع خطأ تحقق 400.
نقاط النهاية الموصى بها¶
GET /api/v1/bmi- واجهة برمجة تطبيقات BMIGET /api/v1/tdee- واجهة برمجة تطبيقات TDEEGET /api/v1/bmr- واجهة برمجة تطبيقات BMRGET /api/v1/protein-calculator- واجهة برمجة تطبيقات حاسبة البروتينGET /api/v1/fitness/heart-rate-zones- واجهة برمجة تطبيقات نطاقات معدل ضربات القلبGET /api/v1/bodyfat- واجهة برمجة تطبيقات نسبة الدهون في الجسم