مقدمة إلى واجهة API العامة لـ Upcart

تتيح لك واجهة API العامة لـ Upcart تخصيص سلتك وأتمتة سير العمل والتكامل مع تطبيقات الجهات الخارجية - سواء كنت مطورًا أو مبتدئًا.
سيرشدك هذا الدليل عبر الأساسيات ويساعدك على البدء في بناء وظائف مخصصة داخل درج السلة الخاص بك. 👉 عرض وثائق واجهة API العامة الكاملة لـ Upcart

نظرة عامة

واجهة API العامة هي مجموعة من دوال JavaScript ومستمعي الأحداث التي تتيح لك:

التفاعل مع تغييرات السلة — اكتشاف متى تُضاف العناصر أو تُزال أو تُحدَّث.
تشغيل الإجراءات — مثل فتح السلة أو إغلاقها برمجيًا.
بناء ميزات مخصصة — حقن منطقك الخاص أو مكونات واجهة المستخدم مباشرةً داخل درج السلة.

وهي مفيدة بشكل خاص عند العمل في قسم Custom HTML في محرر Upcart، حيث يمكنك استخدام هذه الدوال لإنشاء تجارب فريدة للمتسوقين.

ما تحتاجه للبدء

قبل استخدام واجهة API الخاصة بـ Upcart، تأكد من أن لديك:

الوصول إلى Upcart في متجر Shopify الخاص بك
تأكد من تثبيت Upcart وتفعيله في متجرك.
فهم أساسي لـ JavaScript
تستخدم العديد من التخصيصات مقتطفات مكتوبة مسبقًا، لكن معرفة أساسيات JavaScript تساعد إذا أردت تجاوز الأساسيات.

إضافة أول سكربت Upcart API لك

يمكنك البدء في استخدام واجهة API مباشرةً من محرر Upcart:

انتقل إلى Upcart Editor → Settings → Custom HTML → Scripts (before load)
الصق السكربت الخاص بك — على سبيل المثال:

<script>
  window.upcartSubscribeAddedToCart(function(event) {
    console.log("You just added " + event.item.title + " to your cart!");
  });
</script>

ملاحظة: لا تزال الأمثلة القديمة التي تستخدم window.upcartOnAddToCart تعمل ولكنها مهملة وتسجل تحذيرًا في وحدة التحكم. استخدم upcartSubscribeAddedToCart لجميع السكربتات الجديدة.

احفظ تغييراتك، ثم اختبرها في متجرك:

افتح أدوات المطور (F12 أو Ctrl + Shift + J على Windows، وCmd + Option + J على Mac)
أضف منتجًا إلى سلتك
تحقق من علامة تبويب Console بحثًا عن الرسالة:
"You just added [product title] to your cart!"

🎉 إذا رأيت الرسالة، فإن أول سكربت API لديك يعمل!

ابدأ في تخصيص سلتك

الآن بعد أن أصبحت جاهزًا، يمكنك استخدام واجهة API للقيام بجميع أنواع الأشياء الرائعة — مثل فتح السلة تلقائيًا عند إضافة العناصر، أو تحديث الأدوات المخصصة، أو إرسال أحداث التحليلات. للاطلاع على المراجع الكاملة للدوال والأمثلة، راجع وثائق واجهة API العامة لـ Upcart.

البدء

وحدات السلة

إعدادات السلة

زر السلة الثابت

Multicart

التخصيصات

التحليلات

التكاملات والتوافق

الفوترة والحساب

استكشاف الأخطاء وإصلاحها

مقدمة إلى واجهة API العامة لـ Upcart

نظرة عامة

ما تحتاجه للبدء

إضافة أول سكربت Upcart API لك

ابدأ في تخصيص سلتك

المزيد من الموارد

​نظرة عامة

​ما تحتاجه للبدء

​إضافة أول سكربت Upcart API لك

​ابدأ في تخصيص سلتك

​المزيد من الموارد

نظرة عامة

ما تحتاجه للبدء

إضافة أول سكربت Upcart API لك

ابدأ في تخصيص سلتك

المزيد من الموارد