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

واجهة برمجة تطبيقات FFMI

حساب مقاييس FFMI مع إخراج بتنسيق اختياري ودعم وحدات القياس للإدخالات بوحدات القياس أو الإمبراطورية.

نقطة النهاية

  • GET /api/v1/ffmi
  • POST /api/v1/ffmi/post

المعلمات

الاسم النوع مطلوب الإدخال الوصف
sex سلسلة (male, female) نعم استعلام/جسم الجنس البيولوجي.
height رقم نعم استعلام/جسم الطول (وحدات القياس المترية، وحدات القياس الإمبراطورية).
weight رقم نعم استعلام/جسم الوزن (وحدات القياس المترية، وحدات القياس الإمبراطورية).
body_fat رقم نعم استعلام/جسم نسبة الدهون في الجسم.
unit سلسلة (metric, imperial) لا استعلام/جسم وضع الإدخال. القيمة الافتراضية: metric.
format سلسلة (yes, no) لا استعلام/جسم مفتاح تفعيل تنسيق الإخراج.
lang سلسلة لا استعلام لغة الاستجابة (وحدات القياس المترية، وحدات القياس الإمبراطورية، en, es, de, fr, pt, ja, hi, ar).

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

  • إضافة تقييم جودة الكتلة العضلية إلى منتجات تكوين الجسم.
  • مقارنة FFMI الخام مقابل FFMI الموحد للمقارنات العادلة.
  • تمكين رؤى مخصصة للرياضيين مع نطاقات محددة حسب الجنس.

ابدأ الآن

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

curl -X GET "https://api.hefitapi.com/api/v1/ffmi?sex=male&height=178&weight=82&body_fat=16&unit=metric&format=yes&lang=en" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.hefitapi.com/api/v1/ffmi/post?lang=en" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"sex":"male","height":178,"weight":82,"body_fat":16,"unit":"metric","format":"yes"}'

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

معلومات

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

{
  "FFMI": "19.38 kg/m2",
  "Normalized FFMI": "19.51 kg/m2",
  "Fat-free mass": "68.88 kg",
  "Total body fat": "13.12 kg",
  "Sex": "male",
  "Unit": "metric",
  "ffmi_value": 19.38,
  "normalized_ffmi_value": 19.51,
  "fat_free_mass_kg": 68.88,
  "total_body_fat_kg": 13.12,
  "ffmi_band": "standard",
  "ffmi_band_label": "Standard",
  "risk_signal": "Lean mass status is within expected range.",
  "action_plan": ["Progress overload gradually"],
  "monitoring_plan": "Track every mesocycle.",
  "language": "en",
  "_enterprise": {
    "client": "Acme Health",
    "plan": "pro",
    "request_id": "de948be84a08433f",
    "quota": 120,
    "usage_tracking": true
  },
  "_api_metadata_": {
    "endpoint_name": "ffmi",
    "response_language": "en"
  }
}

التوجه التجاري

مثالية لتحليلات الجسم المتقدمة، ومنتجات التدريب القائم على القوة، ومجموعات مراقبة الرياضيين.

ملاحظة

format=no تُرجع تمثيلًا رقميًا غير نصي للحقول الرئيسية لعرض FFMI.

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