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

واجهة برمجة تطبيقات العناصر الغذائية الأساسية

ابحث عن الاحتياجات اليومية للعناصر الغذائية الأساسية حسب اسم العنصر الغذائي، والعمر والجنس، مع إرشادات تأخذ في الاعتبار مرحلة الحياة.

نقطة النهاية

  • GET /api/v1/micronutrient
  • POST /api/v1/micronutrient/post

المعلمات

الاسم النوع مطلوب In الوصف
gender سلسلة نعم استعلام/جسم male أو female.
age عدد صحيح نعم استعلام/جسم العمر بالسنوات؛ يدعم فئات الأعمار من 9 سنوات فما فوق.
micronutrient سلسلة نعم استعلام/جسم مفتاح العنصر الغذائي (مفاتيح ذات صلة بـ calcium, iron, magnesium, b12، إلخ).
lang سلسلة لا استعلام لغة الاستجابة (en, es, de, fr, pt, ja, hi, ar).

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

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

ابدأ الآن

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

curl -X GET "https://api.hefitapi.com/api/v1/micronutrient?gender=female&age=29&micronutrient=iron&lang=en" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.hefitapi.com/api/v1/micronutrient/post?lang=en" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"gender":"male","age":55,"micronutrient":"magnesium"}'

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

معلومات

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

{
  "Micronutrient": "iron",
  "Requirement": "18 mg/d",
  "requirement_value": 18,
  "requirement_unit": "mg/d",
  "Gender": "female",
  "Age": "29 yr",
  "age_group": "19-30 y",
  "life_stage": "adult",
  "life_stage_label": "Adult",
  "priority_focus": ["Prioritize nutrient density and absorption quality"],
  "monitoring_plan": "Review dietary adequacy in periodic nutrition check-ins.",
  "_enterprise": {
    "client": "Acme Health",
    "plan": "pro",
    "request_id": "f9b92ab61182d57e",
    "quota": 120,
    "usage_tracking": true
  },
  "_api_metadata_": {
    "endpoint_name": "micronutrient",
    "response_language": "en"
  }
}

وضع المنتج

مناسب تمامًا لمواقع تعليم التغذية، وأنظمة التخطيط للوجبات، ومنتجات الصحة الوقائية المؤسسية.

ملاحظة

عند إدخال العمر في نطاقات مدعومة، يتم إرجاع رمز HTTP 400 لأنه لم يتم تعريف أي حاوية للاحتياجات.

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