- API
- نقاط النهاية
- /list-to-cart
Generate purchasable product matches from a shopping list
حوّل أي قائمة مشتريات، بما في ذلك الملاحظات المكتوبة بخط اليد أو المذكرات الصوتية أو النصوص المنسوخة، إلى سلة تجارة إلكترونية مباشرة مملوءة بعناصر من مخزون متجرك. تتضمن مطابقة ذكية بين عدة متاجر، وبدائل ذكية، وكميات محسّنة. حل فريد لا يقدمه أي منافس حاليًا للفهارس الواقعية. حالات الاستخدام: متاجر البقالة وتجارة التجزئة عبر الإنترنت • يلصق العميل قائمة المشتريات في التطبيق ← تُملأ السلة بمنتجات حقيقية من الفهرس بنقرة واحدة. مطابقة ذكية على أساس الفهرس الفعلي. تطبيقات الصحة والعافية • ينشئ التطبيق قائمة أسبوعية بناءً على النظام الغذائي ← يحوّل زر «اشترِ الكل من [Partner Supermarket]» القائمة إلى سلة حقيقية. المطاعم وخدمات تقديم الطعام • مطعم يقدّم وصفات لتحضيرها في المنزل: يضغط العميل على «اشترِ المكونات» ويحصل على سلة مملوءة بمنتجات من السوبرماركت الشريك. أطقم الوجبات والتوصيل • قدّم خيار «اشترِ المكونات من أقرب سوبرماركت إليك» كبديل للأطقم المعبأة مسبقًا. تعمل API على مطابقة المكونات بالمتاجر المحلية. المساعدون الصوتيون وروبوتات الدردشة • يقول المستخدم «أضف الحليب والخبز والموزاريلا». تفسّر API النص الطبيعي وتطابقه مع المنتجات الفعلية.
الطلب
عناصر قائمة المشتريات المطلوب مطابقتها مع منتجات الفهرس
ListToCartRequest
نص الطلب الذي يحتوي على قائمة التسوق
object
ListToCartRequest
نص الطلب الذي يحتوي على قائمة التسوق
items
object[]
items
ListToCartItemInput
عنصر واحد في قائمة التسوق، يتضمن الاسم والكمية ووحدة القياس
object
ListToCartItemInput
عنصر واحد في قائمة التسوق، يتضمن الاسم والكمية ووحدة القياس
itemId
المعرّف الفريد لهذا العنصر، ويُستخدم لمطابقة إدخالات الطلب والاستجابة. يجب أن يكون فريدًا ضمن الطلب
name
اسم العنصر باللغة المحددة في ترويسة Accept-Language
quantity?
كمية العنصر المرتبطة بمعرّف MeasureUnitId المحدد
measureUnitId?
معرّف وحدة القياس؛ يمكن حله عبر GET /definitions/measure-units