بيانات الاعتماد والبيئات#

اضبط بيانات الاعتماد الخاصة بواجهة متجرك التي تستخدم Visualizer SDK، وبـ Product Import API عند الحاجة. لا تؤدي قراءة الوثائق العامة إلى إنشاء بيانات اعتماد أو منح حق الوصول إلى متجر.

أين تُستخدم كل بيانات اعتماد؟#

Publishable Key مخصص للاستخدام في المتصفح. يجب إبقاء Client Secret على خادمك. لا تلصقهما مطلقًا في قالب أو ملف Markdown عام أو حزمة عميل أو لقطة شاشة للدعم.

الحصول على بيانات الاعتماد وإعدادها#

افتح لوحة تحكم التاجر، واختر المتجر الصحيح، واستعرض تكامل SDK والإعدادات. اتبع تعليمات الإعداد الأولي لـ Client ID و Client Secret.

فعّل Allowed Origins (CORS)#

قبل الاختبار أو النشر لـ SDK، افتح لوحة التحكم → الإعدادات للمتجر الصحيح واعثر على Allowed Origins (CORS).

1. أدخل نقاط الأصل (origins) للواجهات الأمامية التي ستنزّل SDK، مفصولة بفواصل. مثال: https://example.com, https://www.example.com, https://shop.example.com.
2. استخدم البروتوكول واسم المضيف، بالإضافة إلى المنفذ إن وُجد، من دون مسار صفحة أو سلسلة استعلام أو جزء مرجعي. أضف نقطة أصل المعاينة أو الاستضافة التجريبية أيضًا إذا اختبرت SDK هناك؛ استخدم http://localhost:3000 فقط عندما تكون نقطة اختبار المحلية الفعلية.
3. انقر حفظ، ثم أعد تحميل الواجهة الأمامية واختبر SDK مرة أخرى.

تحقّق من الـ URL الفعلي الذي يزوره العملاء: https://example.com و https://www.example.com نقطتا أصل مختلفتان. لا يثبت نجاح اختبار محلي أو على بيئة معاينة أن نقطة الأصل المنشورة مفعّلة.

استبدال القيم الواردة في الأمثلة#

تستخدم الأمثلة قيمًا نائبة مثل <SHOP_ID> و<PUBLISHABLE_KEY> و<YOUR_CLIENT_SECRET>. استبدلها في البيئة المقصودة فقط. قد تُرمّز أمثلة HTML الأقواس الزاوية بصيغتي < و>؛ استبدل القيمة النائبة كاملةً، بما في ذلك هذا الترميز.

بيئات SDK و Product Import#

يحمّل المتصفّح https://sdk.ideal.house/sdk.js مع Shop ID و Publishable Key من نفس المتجر. يستمر Product Import API في استخدام https://sdkapi.ideal.house مع مصادقته على الخادم كما هو موثق.

فعّل نقاط أصول واجهاتك الأمامية للمعاينة والإنتاج بشكل منفصل كما هو موضح أعلاه. استعمل منتجات اختبار مُعدة مسبقًا قبل النشر، ثم أكمل قائمة التحقق من الإطلاق.