مقيّس حصص الوصفة

تُرفض الحصص أو الكميات غير الموجبة والقوائم الفارغة والقيم غير المنتهية بـ invalid_input حتى لا تُنتج بيانات سيئة دفعةً صفرية صامتة. المسار حساب حتمي بحت—بلا شبكة ولا بذور عشوائية ولا اعتماد على الساعة—لذا يُرجع مشغّل المتصفح المجاني وواجهة API مسبقة الدفع نفس JSON بعد تقريب عشري ثابت في كل استدعاء.

كيف تستدعون API: الحقول والتحقق وشكل الاستجابة

كل amount يجب أن يكون موجبًا ومنتهيًا كذلك؛ تُرفض القائمة الفارغة لأنه لا شيء للقياس. فضّلوا وضع الوحدات في حقل names الاختياري لا داخل سلاسل amount حتى تبقى مئتان وخمسون والدقيق بالجرام منفصلين ولا يضطر الحلّال لتحليل نص مختلط. أرسلوا جسم JSON مع amounts كمصفوفة إلزامية من أعداد منتهية موجبة—أو سلسلة مفصولة بفواصل في نماذج النص—بالإضافة إلى original_servings وtarget_servings (تشمل الأسماء البديلة servings وfrom_servings وoriginal لعدّ المصدر، وtarget وto_servings وnew_servings للوجهة). يجب أن يكون عدّا الحصص أعدادًا منتهية موجبة تمامًا؛ الصفر والسالب والمفقود وغير الرقمي يعيد invalid_input ولا يُحاسب أبدًا. تبقى القيم المطلقة ضمن الحد المنشور تريليون واحد، وطول القائمة محدود حتى ينهي Worker بسرعة. عند النجاح تعيد الاستجابة amounts مقرّبة وscaled وscale_factor وoriginal_servings وtarget_servings وcount وnames اختيارية وصفوف ingredients تربط كل كمية أصلية بقيمتها المُقاسة وformula وmessage وsteps مرتبة لمسارات التدقيق. فشل التحقق—amounts فارغة أو أعداد غير منتهية أو حصص أو كميات غير موجبة أو حقول إلزامية مفقودة—يعيد invalid_input مع رسالة تسمّي المشكلة. التسعير ثابت $0.002 لكل طلب ناجح بوحدة item وسعر وحدوي هامشي صفر.

نصائح عملية وأخطاء شائعة وحدود وأدوات ذات صلة

عند القياس للضيوف تحقّقوا من تناسب كل سطر في البطاقة—بعض الوصفات تترك التتبيل حسب الذوق أو تثبت حجم المقلاة، فقد تقيسون المكونات السائبة وتتركون قرصات التوابل للحكم. تستهدف هذه الصفحة من يبحث عن مقيّس حصص الوصفة أو قياس المكونات حسب الحصص أو حاسبة عائد الدفعة؛ ليست محوّل وحدات ولا مقدّر تغذية ولا مخطط وجبات كامل. فضّلوا أدوات الطهي أو التحويل الشقيقة عندما تحتاجون أكواب دقيق إلى جرامات أو ملاعق كبيرة إلى مليلترات، ثم قيسوا الأرقام الناتجة هنا. فحوصات الذهاب والإياب سهلة: أعيدوا حساب كل amount × المعامل يدويًا وأكّدوا أنه يساوي الإدخال scaled المنشور بنفس تقريب اثنتي عشرة منزلة، وأكّدوا أن تغيير المستهدف وحده يقيس كل سطر بنسبة مع بقاء التسميات متراصفة. حافظوا دائمًا على original_servings غير صفري وموجب في نماذج العميل قبل الإرسال؛ سترمي API مع ذلك invalid_input واضحًا إذا تسلّل صفر أو عدّ سالب، لأن القسمة على صفر أو اختراع دفعة سالبة ليس قياسًا ذا معنى. فضّلوا الأرقام على سلاسل وحدات منسّقة مسبقًا داخل amounts؛ ضعوا الوحدات في names الاختياري. تُقرَّب القيم العائمة قرب الحدود إلى اثنتي عشرة منزلة لمقارنة JSON مستقرة بين المحركات. المهام الفاشلة التي تعيد invalid_input لا تستهلك الرصيد المسبق، فيبقى استكشاف السكربتات رخيصًا حين يرسل المتعلمون عمدًا حصصًا صفرية أو قوائم فارغة. للتموين حوّلوا دفعة تجريبية لثمانية أطباق إلى خدمة ثمانية وأربعين بإرسال original_servings ثمانية وtarget_servings ثمانية وأربعين فيُشتقّ المعامل تلقائيًا دون حقل مضاعف منفصل.