> ## 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.

# الأسئلة الشائعة حول واجهة Upcart API

> اعثر على إجابات للأسئلة الشائعة حول استخدام واجهة Upcart API، بما في ذلك الإعداد واستكشاف الأخطاء والتكاملات مع تطبيقات خارجية.

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

فيما يلي إجابات لبعض الأسئلة الأكثر شيوعًا حول استخدام واجهة Upcart API.

* **[أين تُضاف نصوص Upcart API البرمجية؟](#where-to-add-upcart-api-scripts)**
* **[هل يجب أن أكون مطوّرًا لاستخدام واجهة Upcart API؟](#do-i-need-to-be-a-developer-to-use-upcarts-api)**
* **[هل يمكن لواجهة Upcart API التكامل مع تطبيقات خارجية أخرى؟](#can-upcarts-api-integrate-with-other-third-party-apps)**
* **[كيف أختبر ما إذا كانت تغييرات API تعمل؟](#how-do-i-test-if-my-api-changes-are-working)**
* **[ماذا أفعل إذا لم يعمل نص API برمجي؟](#what-should-i-do-if-an-api-script-isnt-working)**
* **[كيف أتراجع عن التغييرات إذا أضفت نصًا برمجيًا يعطّل شيئًا ما؟](#how-do-i-undo-changes-if-i-add-a-script-that-breaks-something)**

***

<div id="where-to-add-upcart-api-scripts">
  ## **أين تُضاف نصوص Upcart API البرمجية؟**
</div>

يمكنك إضافة النصوص البرمجية في إعدادات Custom HTML الخاصة بـ Upcart أو مباشرة في كود قالب Shopify. يعتمد الخيار الأفضل على احتياجات التخصيص لديك.

<div id="how-do-i-use-upcarts-custom-html">
  ## كيف أستخدم Custom HTML في Upcart؟
</div>

1. انتقل إلى **Upcart → Settings → Custom HTML**
2. استخدم نصوص API البرمجية لتعديل سلوك السلة، مثل توقيت الفتح أو عروض البيع الإضافي (upsell)
3. عدّل عناصر خارج Upcart، مثل إخفاء أزرار صفحة المنتج

<div id="example-hide-the-sticky-cart-button-when-the-cart-is-empty">
  #### 💡 *مثال: إخفاء زر السلة الثابت عندما تكون السلة فارغة*
</div>

```
<script>  
  window.upcartSubscribeCartLoaded((event) => {  
    const itemCount = event.cart.items.reduce((total, item) => total + item.quantity, 0);  
    document.querySelector("#upCartStickyButton").style.display = itemCount === 0 ? "none" : "block";  
    console.log("Sticky Cart is hiding!");  
  });  
</script>
```

<Note>
  **ملاحظة قديمة:** ما زالت دوال الاستدعاء `window.upcartOnCartLoaded` تعمل لكنها مهملة وتسجّل تحذيرات في وحدة التحكم. استخدم `upcartSubscribeCartLoaded` لجميع النصوص البرمجية الجديدة. لاحظ أن `event.cart` لا يحتوي على خاصية `item_count` — استخدم `event.cart.items.reduce((total, item) => total + item.quantity, 0)` لحساب إجمالي عدد العناصر.
</Note>

***

<div id="do-i-need-to-be-a-developer-to-use-upcarts-api">
  # **هل يجب أن أكون مطوّرًا لاستخدام واجهة Upcart API؟**
</div>

لا! واجهة Upcart API سهلة الاستخدام حتى بدون مهارات برمجية. كثير من الميزات مدمجة، وتتضمن [وثائق التخصيص](/ar/upcart/add_a_mandatory_terms_and_conditions_checkbox_to_your_cart) لدينا نصوصًا برمجية جاهزة يمكنك نسخها إلى إعدادات Custom HTML في Upcart — دون الحاجة إلى برمجة!

إذا أردت كتابة نصوص برمجية مخصصة، فمعرفة أساسيات JavaScript تفيد. وإذا كنت جديدًا على JavaScript، فلا تقلق! يمكن أن تساعدك هذه الموارد المناسبة للمبتدئين — **W3Schools** و\*\*[MDN Web Docs](https://developer.mozilla.org/en-US/docs/Web/JavaScript)\*\* — على البدء.

***

<div id="can-upcarts-api-integrate-with-other-third-party-apps">
  # هل يمكن لواجهة Upcart API التكامل مع تطبيقات خارجية أخرى؟
</div>

نعم! تعمل واجهة Upcart API مع تطبيقات الترجمة والتحليلات والبيع الإضافي (upsell) وغيرها. بعضها يتكامل تلقائيًا، بينما قد يحتاج بعضها الآخر إلى نص برمجي صغير.

على سبيل المثال، إذا كنت تستخدم **[TripleWhale](https://kb.triplewhale.com/en/articles/6610178-adding-the-triple-pixel-to-third-party-checkouts#h_eccf979512)** للتتبع، فستحتاج إلى إضافة النص البرمجي التالي لضمان تسجيله لنشاط السلة بشكل صحيح:

```
<script>  
window.upcartSubscribeAddedToCart((event) => {  
	window.TriplePixel('AddToCart', {item: event.item.variantId, q: event.item.quantityAdded});  
});  
</script>
```

<Note>
  **ملاحظة قديمة:** ما زالت دوال الاستدعاء `window.upcartOnAddToCart` تعمل لكنها مهملة وتسجّل تحذيرات في وحدة التحكم. استخدم `upcartSubscribeAddedToCart` لجميع النصوص البرمجية الجديدة. لاحظ أن خصائص الحدث موجودة في `event.item` (مع `variantId` و`quantityAdded`)، ولا تُمرَّر كمعاملات منفصلة.
</Note>

نظرًا لاختلاف كل تطبيق، استشر فريق دعم تطبيقك لمعرفة ما إذا كان يلزم كود إضافي. لا يقدم Upcart دعمًا للنصوص البرمجية الخاصة بالتطبيقات الخارجية، لكن مزوّد تطبيقك قد يملك دليل تكامل.

***

<div id="how-do-i-test-if-my-api-changes-are-working">
  # كيف أختبر ما إذا كانت تغييرات API تعمل؟
</div>

بعد إضافة نص برمجي إلى إعدادات Custom HTML في Upcart، اتبع هذه الخطوات للتأكد من عمله:

1. **حدّث متجرك** وأضف عنصرًا إلى السلة.

2. **امسح ذاكرة التخزين المؤقت** وحاول مرة أخرى لرؤية أحدث التغييرات.

3. **أضف رسالة اختبار**: أدرج `console.log("The script works!");` قبل `</script>` للتحقق من تشغيل نصك البرمجي.

4. تحقق من وحدة تحكم المتصفح:

   * افتح **Dev Tools** (‏`F12` أو `Ctrl + Shift + J` على Windows، و`Cmd + Option + J` على Mac).
   * انتقل إلى علامة تبويب **Console** وابحث عن **"The script works!"**
   * إذا رأيت الرسالة، فنصك البرمجي يعمل! وإذا لم ترها، فقد لا يكون النص البرمجي يُنفَّذ بشكل صحيح.

5. **اختبر إجراءات مختلفة** (مثل إزالة عنصر) للتأكد من السلوك المتوقع.

**استكشف المشاكل** بالتحقق من الأخطاء الإملائية أو أخطاء وحدة التحكم وتعديل الكود حسب الحاجة.

***

<div id="what-should-i-do-if-an-api-script-isnt-working">
  # ماذا أفعل إذا لم يعمل نص API برمجي؟
</div>

إذا لم يعمل نص API البرمجي لديك، فجرّب خطوات استكشاف الأخطاء التالية:

* **تحقق من الأخطاء الإملائية** – حتى الأخطاء الصغيرة قد تعطّل النص البرمجي. ابحث عن أحرف مفقودة أو صيغة غير صحيحة.

* **تحقق من موضع النص البرمجي** – تأكد من أن النص البرمجي في القسم الصحيح ضمن Upcart → Settings → Custom HTML. لدى Upcart عشرة أقسام للنصوص البرمجية (تسع نقاط حقن HTML بالإضافة إلى قسم Scripts-before-load واحد) — [راجع هذه الأقسام هنا.](/ar/upcart/custom_html)

* **تحقق من وحدة تحكم المتصفح** – اتبع الخطوات أعلاه للبحث عن الأخطاء.

* **جرّب نصًا برمجيًا مختلفًا** – جرّب نص Upcart API برمجيًا جاهزًا آخر لمعرفة ما إذا كانت المشكلة في الكود الخاص بك.

* **ما زلت عالقًا؟** – إذا كنت تعدّل قالب Shopify أو تدمج تطبيقات خارجية، فيمكن لخبير Shopify من [دليل شركاء Shopify](https://www.shopify.com/partners/directory) مساعدتك.

من المفترض أن تساعدك هذه الخطوات على تحديد معظم مشاكل النصوص البرمجية وحلها!

***

<div id="how-do-i-undo-changes-if-i-add-a-script-that-breaks-something">
  # كيف أتراجع عن التغييرات إذا أضفت نصًا برمجيًا يعطّل شيئًا ما؟
</div>

إذا أضفت نصًا برمجيًا لا يعمل كما هو متوقع، فيمكنك **إزالته أو تعطيله بسهولة**:

* **انتقل إلى إعدادات Custom HTML في Upcart** حيث أُضيف النص البرمجي.

* **أزل النص البرمجي** أو عطّله مؤقتًا بإضافة `//` في بداية كل سطر (هذا يحوّله إلى تعليق ويمنع تشغيله).

* **احفظ التغييرات وحدّث متجرك** للتحقق من حل المشكلة.

إذا استمرت المشكلة، فجرّب مسح ذاكرة التخزين المؤقت أو التراجع عن تغييرات القالب الأخيرة — فهذا غالبًا يحل التعارضات الخفية.

***

🚧 **هل تبحث عن تخصيصات متقدمة؟**

هل تحتاج إلى تخصيصات على مستوى المتجر أو تكاملات مع تطبيقات خارجية؟ قد تحتاج إلى مطوّر لإضافة واجهة Upcart API إلى قالب Shopify الخاص بك.

فكّر في توظيف خبير Shopify عبر **[دليل شركاء Shopify](https://www.shopify.com/partners/directory)** وشارك معه [وثائق API](/ar/upcart/introduction_to_upcarts_public_api) الخاصة بنا للمساعدة