ForHosting KIT · أدوات المطورين

حساب غرامات المغذيات الكبرى من السعرات والنسب

تحوّل حاسبة توزيع المغذيات الكبرى هدف السعرات اليومية وثلاث نسب مستهدفة إلى كميات عملية بالغرام من البروتين والكربوهيدرات والدهون.

● Betaمجاني · داخل متصفحك

شغّل الأداة مجانًا اطّلع على الـAPI

استخدمها من الويبAPIالبريدTelegramالتطبيق قريبًا

تستخدم الحاسبة معاملات الطاقة القياسية: أربع سعرات لكل غرام من البروتين، وأربع لكل غرام من الكربوهيدرات، وتسع لكل غرام من الدهون. تتحقق من كل قيمة وترفض أي توزيع لا يبلغ مجموع نسبه 100. لذلك تلائم خطط التغذية وإجراءات الإرشاد وجداول إعداد الوجبات وتطبيقات اللياقة التي تحتاج إلى نتيجة واضحة قابلة للتكرار، من دون تعديل النسب المدخلة في الخفاء.

أدخلوا هدفا كاملا قائما على السعرات

ابدؤوا بإجمالي السعرات المقرر ليوم واحد، ثم حددوا الحصة المخصصة للبروتين والكربوهيدرات والدهون. تمثل كل حصة نسبة من الطاقة، وليست نسبة من وزن الطعام ولا كمية بالغرام. فعلى سبيل المثال، يعني هدف بروتين قدره 30 بالمئة أن هذه الحصة من ميزانية السعرات اليومية تأتي من البروتين. القيم الأربع مطلوبة كي يبقى الحساب صريحا وقابلا للتكرار. يجب أن تكون السعرات عددا محدودا أكبر من الصفر، وأن تكون كل نسبة عددا محدودا من صفر إلى 100 شاملين. لذلك يمكن أن تخصص الخطة صفرا لأحد المغذيات عمدا، بينما تُرفض الحصص السالبة أو المستحيلة. أدخلوا الأرقام من دون علامة النسبة أو وحدة السعرات. تعيد الاستجابة مقدار السعرات المقبول والتوزيع الكامل والغرامات المحسوبة، مما يتيح تسجيل الافتراضات التي أنتجت النتيجة بدقة. لا تختار هذه الإمكانية هدف السعرات أو النسبة المناسبة لشخص بعينه؛ بل تنفذ العملية الحسابية على الأهداف التي سبق أن اخترتموها.

افهموا تحويل السعرات إلى غرامات

يوزع الحساب أولا السعرات اليومية على كل مغذ كبير. يضرب إجمالي السعرات في نسبة المغذي ثم يقسم الناتج على 100. بعد ذلك يحول الطاقة المخصصة إلى غرامات باستخدام أربع كيلوسعرات لكل غرام من البروتين، وأربع لكل غرام من الكربوهيدرات، وتسع لكل غرام من الدهون. لنفترض هدفا قدره 2,000 سعرة وتوزيعا من 30 بالمئة بروتين و40 بالمئة كربوهيدرات و30 بالمئة دهون. يحصل البروتين على 600 سعرة، أي 150 غراما، وتحصل الكربوهيدرات على 800 سعرة، أي 200 غرام. أما الدهون فتحصل على 600 سعرة، أي نحو 66.666667 غراما، لأنها توفر طاقة أكبر في الغرام الواحد. تُقرب النتائج إلى ست منازل عشرية كحد أقصى لتجنب شوائب الفاصلة العائمة مع الحفاظ على دقة مفيدة. لا تستخدم الخوارزمية شبكة أو عشوائية أو حالة مخزنة أو وقتا حاليا. لذلك تنتج مدخلات JSON المتطابقة مخرجات JSON متطابقة دائما، وهو أمر مفيد للأتمتة والاختبارات والجداول والخدمات التي تتطلب نتائج مستقرة.

صححوا مجموع النسب قبل الحساب

يجب أن يبلغ مجموع نسب البروتين والكربوهيدرات والدهون 100 لأنها تصف ميزانية السعرات كاملة. إذا كان المجموع 95 بقي خمسة بالمئة بلا وجهة، وإذا كان 110 وزعت الخطة طاقة تفوق الهدف المحدد. بدلا من تسوية القيم أو تغييرها بصمت، تعيد الإمكانية خطأ إدخال غير صالح يوضح وجوب بلوغ المجموع 100. يكشف هذا السلوك الصارم أخطاء الإدخال ويمنع عرض نتيجة تبدو موثوقة لكنها مبنية على افتراضات لم تعتمدُوها. لا يُستخدم هامش ضئيل جدا إلا لاستيعاب التمثيل المعتاد للفاصلة العائمة، وليس لقبول نسب ناقصة فعليا. عند ظهور خطأ، راجعوا حقول النسب الثلاثة بدلا من تغيير السعرات، لأن القاعدة تتعلق بالتوزيع نفسه. تجمع الاستجابة الناجحة بين النسب الأصلية والغرامات الناتجة كي تعرضها الأنظمة اللاحقة معا. تعاملوا مع هذه القيم بصفتها أهدافا للتخطيط لا قياسات سريرية؛ فملصقات الأغذية والوصفات والتقريب والألياف والكحول والاحتياجات الفردية أمور ينبغي أن تعالجها منظومة التغذية المحيطة بهذا الحساب.

حالات الاستخدام

إعداد هدف يومي للوجبات

حوّلوا هدف السعرات والنسبة المحددين مسبقا إلى غرامات ترشد إعداد الوصفات والحصص.

التحقق من حسابات خطة إرشادية

تأكدوا من اكتمال التوزيع المقترح قبل حفظ الأهداف المحسوبة للشخص المستفيد.

تشغيل تطبيق للياقة

أنشئوا غرامات حتمية من دون تكرار قواعد التحويل في عدة برامج عميلة وخدمات.

الأسئلة الشائعة

هل يجب أن يبلغ مجموع النسب 100؟

نعم. يعيد الحساب خطأ إدخال غير صالح إذا لم يبلغ مجموع البروتين والكربوهيدرات والدهون 100.

كيف تتحول السعرات إلى غرامات؟

تُقسم سعرات البروتين والكربوهيدرات على أربعة، بينما تُقسم سعرات الدهون على تسعة.

هل يمكن تخصيص صفر بالمئة لمغذ كبير؟

نعم. يمكن أن تتراوح كل نسبة من صفر إلى 100، بشرط أن يظل مجموع النسب الثلاث 100.

هل توصي الحاسبة بنسبة معينة؟

لا. تحسب الغرامات من القيم التي تقدمونها ولا توفر مشورة طبية أو غذائية.

ما تكلفة طلب API؟

السعر الأساسي المنشور هو $0.002 لكل طلب. ويمكن لتجربة المتصفح استخدام الحساب الحتمي نفسه.

للمطوّرين — الوصول عبر API

كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.

الـEndpoint

POSThttps://api.kit.forhosting.com/calc2/macro-split-calculate

صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.

استدعِ الخدمة من بيئتك

curl -X POST https://api.kit.forhosting.com/calc2/macro-split-calculate \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"calories":2000,"protein_percent":30,"carb_percent":40,"fat_percent":30}'

const res = await fetch("https://api.kit.forhosting.com/calc2/macro-split-calculate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "calories": 2000,
    "protein_percent": 30,
    "carb_percent": 40,
    "fat_percent": 30
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/calc2/macro-split-calculate",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "calories": 2000,
    "protein_percent": 30,
    "carb_percent": 40,
    "fat_percent": 30
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/calc2/macro-split-calculate", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"calories":2000,"protein_percent":30,"carb_percent":40,"fat_percent":30}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"calories":2000,"protein_percent":30,"carb_percent":40,"fat_percent":30}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/calc2/macro-split-calculate", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "calories": 2000,
  "protein_percent": 30,
  "carb_percent": 40,
  "fat_percent": 30
}

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

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "calc2.macro_split_calculate",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.

الأسعار

لكل طلب$0.002

السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.

الأخطاء

HTTP	الرمز	المعنى
`401`	`unauthorized`	مفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك.
`402`	`insufficient_balance`	رصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة.
`404`	`unknown_type`	نوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب.
`429`	`rate_limited`	تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة.

اطّلع على توثيق KIT الكامل ←