> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aftersell.com/llms.txt
> Use this file to discover all available pages before exploring further.

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

> تعلّم كيفية البدء مع واجهة API الخاصة بـ Upcart، وإضافة السكربتات، واختبار التغييرات، وتخصيص سلتك بسهولة.

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

👉 [عرض وثائق واجهة API العامة الكاملة لـ Upcart](https://rokt.notion.site/upcart-public-api)

***

<div id="overview">
  ## نظرة عامة
</div>

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

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

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

***

<div id="what-you-need-to-get-started">
  ## ما تحتاجه للبدء
</div>

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

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

***

<div id="adding-your-first-upcart-api-script">
  ## إضافة أول سكربت Upcart API لك
</div>

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

1. انتقل إلى **Upcart Editor → Settings → Custom HTML → Scripts (before load)**

2. الصق السكربت الخاص بك — على سبيل المثال:

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

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

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

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

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

***

<div id="start-customizing-your-cart">
  ## ابدأ في تخصيص سلتك
</div>

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

للاطلاع على المراجع الكاملة للدوال والأمثلة، راجع **[وثائق واجهة API العامة لـ Upcart](https://rokt.notion.site/upcart-public-api)**.

***

<div id="more-resources">
  ## المزيد من الموارد
</div>

* 🧩 **[الأسئلة الشائعة حول API](/ar/upcart/upcart_api_frequently_asked_questions)** — نصائح استكشاف الأخطاء وإصلاحها والأسئلة الشائعة
* ⚙️ **[الاستخدامات الشائعة لواجهة Upcart API](/ar/upcart/common_upcart_api_uses)** — أمثلة أكواد وقوالب شائعة
* 💡 **[وثائق التخصيص](/ar/upcart/add_a_mandatory_terms_and_conditions_checkbox_to_your_cart)** — سكربتات مكتوبة مسبقًا لمساعدتك على البدء بسرعة
* 🛍️ **[وثائق Cart API من Shopify](https://shopify.dev/docs/api/ajax/reference/cart)** — تعرّف على كيفية تعامل Shopify مع بيانات السلة خلف الكواليس
* 👩💻 هل تحتاج إلى تخصيصات متقدمة؟ فكر في توظيف [Shopify Expert](https://www.shopify.com/ca/partners/directory/services/development-and-troubleshooting/custom-apps-integrations) للتكاملات الأكثر تعقيدًا.