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

واجهة برمجة التطبيقات (API) الخاصة بـ IBW

احسب الوزن المثالي بالكيلوغرام والأوقية مع منطق مُعدّل لحجم الجسم، وذلك للاستخدام في الأدوات الرياضية والطبية.

نقطة النهاية

  • GET /api/v1/ibw
  • POST /api/v1/ibw/post

المعلمات

الاسم النوع إلزامي الإدخال الوصف
height رقم (أكبر من 0) نعم الاستعلام/الجسم الطول بالسنتيمتر.
body_frame سلسلة نعم الاستعلام/الجسم small,medium,large.
gender سلسلة نعم الاستعلام/الجسم male أو female.
formula سلسلة لا الاستعلام hamwi (افتراضي) أو devine.
lang سلسلة لا الاستعلام لغة الاستجابة (en,es,de,fr,pt,ja,hi,ar).

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

  • توحيد تقدير الوزن المثالي عبر المنتجات.
  • دعم المخرجات الخاصة بالصيغ في السياقات السريرية والرياضية.
  • إضافة دقة وتوجيه للمراقبة للأهداف الوزنية الأولية.

ابدأ الآن

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

curl -X GET "https://api.hefitapi.com/api/v1/ibw?height=176&body_frame=medium&gender=male&formula=hamwi&lang=en" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.hefitapi.com/api/v1/ibw/post?formula=devine&lang=en" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"height":165,"body_frame":"small","gender":"female"}'

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

معلومات

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

{
  "ideal_weight": "69.42 kg",
  "formula": "Hamwi",
  "gender": "Male",
  "body_frame": "Medium",
  "ideal_weight_kg": 69.42,
  "ideal_weight_lb": 153.04,
  "height_cm": 176.0,
  "height_m": 1.76,
  "precision_band": "frame_adjusted",
  "precision_label": "Frame Adjusted",
  "risk_signal": "Reference target suitable for phased planning.",
  "action_plan": ["Set sustainable weekly target range"],
  "monitoring_plan": "Reassess with body composition and performance markers.",
  "language": "en",
  "_enterprise": {
    "client": "Acme Health",
    "plan": "pro",
    "request_id": "146e3a98a9a8ec1c",
    "quota": 120,
    "usage_tracking": true
  },
  "_api_metadata_": {
    "endpoint_name": "ibw",
    "response_language": "en"
  }
}

وضع المنتج

مفيد في نماذج الاستقصاء، وخطط التدريب الرقمية، وعمليات الفحص الطبي التي تتطلب تقديرات مُوحّدة للوزن المثالي.

ملاحظة

height, body_frame, و gender مطلوبة لكل من GET و POST.

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