واجهة برمجة التطبيقات لحساب البروتين¶
تقديم توصيات غذائية في إطارات عمل متعددة لخطط التغذية القوية.
نقطة النهاية¶
GET /api/v1/protein-calculatorPOST /api/v1/protein-calculator/post
المعلمات¶
| الاسم | النوع | مطلوب | الاستعلام/الجسم | الوصف |
|---|---|---|---|---|
sex | سلسلة | نعم | الاستعلام/الجسم | male أو female. |
age | رقم (>0) | نعم | الاستعلام/الجسم | العمر بالسنوات. |
height | رقم (>0) | نعم | الاستعلام/الجسم | الطول بالسنتيمتر (metric) أو البوصة (imperial). |
weight | رقم (>0) | نعم | الاستعلام/الجسم | الوزن بالكيلوجرام (metric) أو اللب (imperial). |
activity_level | سلسلة | نعم | الاستعلام/الجسم | sedentary,lightly_active,moderately_active,very_active,extra_active. |
unit | سلسلة | لا | الاستعلام/الجسم | metric (افتراضي) أو imperial. |
lang | سلسلة | لا | الاستعلام | لغة الاستجابة (en,es,de,fr,pt,ja,hi,ar). |
لماذا استخدام هذه النهاية¶
- دمج إرشادات البروتين الأساسية والأداء في مكالمة واحدة.
- دعم محركات الماكرو المخصصة وخطط الوجبات.
- تقديم حقول إرشادات التنفيذ لتحسين وضوح تجربة المستخدم.
مثال على الطلب¶
curl -X GET "https://api.hefitapi.com/api/v1/protein-calculator?sex=male&age=34&height=178&weight=82&activity_level=very_active&unit=metric&lang=en" \
-H "X-API-Key: YOUR_API_KEY"
curl -X POST "https://api.hefitapi.com/api/v1/protein-calculator/post?lang=en" \
-H "Content-Type: application/json" \
-H "X-API-Key: YOUR_API_KEY" \
-d '{"sex":"female","age":31,"height":66,"weight":148,"activity_level":"moderately_active","unit":"imperial"}'
مثال على الاستجابة¶
معلومات
مثال الاستجابة أدناه هو للأغراض التوضيحية فقط. للحصول على هيكل JSON الكامل والواقعي وفي الوقت الفعلي، قد يكون أكثر ثراءً، قم بإجراء طلب إلى هذه النهاية.
{
"sex": "male",
"age": 34.0,
"height_cm": 178.0,
"weight_kg": 82.0,
"unit": "metric",
"activity_level": "very_active",
"tdee_kcal_per_day": 2949.41,
"usda_protein_grams_range": [73.74, 221.21],
"who_protein_grams": 68.06,
"activity_target_protein_g": 131.2,
"activity_target_g_per_kg": 1.6,
"protein_band": "moderate",
"protein_band_label": "Moderate",
"distribution_guidance": ["Split protein across 3-5 meals"],
"action_plan": ["Keep daily protein target consistent"],
"quality_guardrails": ["Prioritize high-quality protein sources"],
"_enterprise": {"client": "Acme Health", "plan": "pro", "request_id": "dad775e89ecac88f", "quota": 120, "usage_tracking": true},
"_api_metadata_": {"endpoint_name": "protein_calculator", "response_language": "en"}
}
وضع المنتج¶
نقطة نهاية أساسية للمنتجات الغذائية ومنصات التدريب وتطبيقات الصحة الأيضية.
ملاحظة
يجب أن تكون الأعمار والطول والوزن أرقامًا موجبة.
نقاط النهاية الموصى بها¶
GET /api/v1/6mwt-calculator- واجهة برمجة تطبيقات 6MwtGET /api/v1/abi-calculator- واجهة برمجة تطبيقات AbiGET /api/v1/ava-calculator- واجهة برمجة تطبيقات AvaGET /api/v1/bri-calculator- واجهة برمجة تطبيقات BriGET /api/v1/bsa-calculator- واجهة برمجة تطبيقات BsaGET /api/v1/carbs-calculator- واجهة برمجة تطبيقات الكربوهيدرات