بناء تطبيقات Shopify: دليل المطور للنظام البيئي لتطبيق Shopify

يستضيف Shopify App Store أكثر من 10000 تطبيق ويدر إيرادات بالمليارات للمطورين. سواء كنت تقوم بإنشاء تطبيق مخصص لتاجر واحد أو تطبيق عام لآلاف المتاجر، فإن فهم بنية تطبيق Shopify وواجهات برمجة التطبيقات والنظام البيئي أمر ضروري. يغطي هذا الدليل كل ما يحتاج المطورون إلى معرفته لإنشاء تطبيقات Shopify وإطلاقها وتوسيع نطاقها في عام 2026.

س: ما هي أنواع تطبيقات Shopify التي يمكنك إنشاؤها؟

هناك ثلاثة أنواع من تطبيقات Shopify: التطبيقات العامة المدرجة في Shopify App Store ليتمكن أي تاجر من تثبيتها، والتطبيقات المخصصة المصممة لمتجر واحد محدد، ومسودة التطبيقات المستخدمة أثناء التطوير والاختبار. تمر التطبيقات العامة بعملية مراجعة Shopify، بينما يتم تثبيت التطبيقات المخصصة مباشرة عبر مسؤول المتجر.

شرح أنواع التطبيقات

التطبيقات العامة

يتم إدراج التطبيقات العامة في Shopify App Store ويمكن تثبيتها بواسطة أي تاجر Shopify. إنهم يستخدمون OAuth للمصادقة ويجب عليهم الالتزام بإرشادات مراجعة تطبيق Shopify.

الخصائص:

• متاح لجميع متاجر Shopify التي يزيد عددها عن 4.8 مليون
• الإيرادات من خلال الاشتراكات أو رسوم الاستخدام أو عمليات الشراء لمرة واحدة
• يجب اجتياز عملية مراجعة تطبيق Shopify
• استخدم OAuth 2.0 لمصادقة التاجر
• يخضع لسياسات متجر التطبيقات Shopify ومعايير الجودة

تطبيقات مخصصة

تم تصميم التطبيقات المخصصة لمتجر واحد ولا تخضع لعملية مراجعة متجر التطبيقات. يتم تثبيتها مباشرة من خلال لوحة إدارة المتجر.

الخصائص:

• مصممة لتاجر واحد محدد
• لا توجد حاجة إلى قائمة متجر التطبيقات
• رموز الوصول التي تم إنشاؤها في مسؤول Shopify
• لا حاجة لتدفق OAuth
• مثالية لمنطق الأعمال والتكاملات المخصصة

مسودة التطبيقات

يتم استخدام مسودة التطبيقات أثناء التطوير. وهي تعمل مثل التطبيقات العامة ولكنها قابلة للتثبيت فقط في متاجر التطوير. يتم تحويلها إلى تطبيقات عامة عند إرسالها إلى متجر التطبيقات.

إعداد بيئة التطوير الخاصة بك

Shopify سطر الأوامر

Shopify CLI هي أداة سطر الأوامر الرسمية لتطوير التطبيقات. فهو يدعم المشاريع ويدير متاجر التطوير ويتولى نشر التطبيقات.

البداية:

1. قم بتثبيت Node.js 18+ وnpm
2. تثبيت Shopify CLI: npm install -g @shopify/cli @shopify/app
3. أنشئ تطبيقًا جديدًا: shopify app init
4. اختر إطار العمل الخاص بك (Remix هو الخيار الافتراضي والموصى به)
5. بدء التطوير: shopify app dev

تقوم واجهة سطر الأوامر (CLI) تلقائيًا بإعداد أنفاق ngrok للتطوير المحلي، وإدارة مصادقة التطبيق، وتوفير إعادة تحميل الوحدة النمطية بشكل سريع.

متجر التطوير

قم بإنشاء متجر تطوير مجاني من خلال لوحة تحكم Shopify Partner الخاصة بك. تتمتع متاجر التطوير بإمكانية الوصول الكامل إلى جميع ميزات Shopify ولا تتطلب خطة مدفوعة. يمكنك إنشاء مخازن تطوير غير محدودة للاختبار.

واجهات برمجة تطبيقات Shopify

يوفر Shopify العديد من واجهات برمجة التطبيقات لحالات الاستخدام المختلفة:

| واجهة برمجة التطبيقات | المصادقة | حالة الاستخدام | |-----|-------------|----------| | واجهة برمجة تطبيقات المشرف (REST) ​​| OAuth / رمز الوصول | إدارة المتجر، الطلبات، المنتجات، العملاء | | واجهة برمجة تطبيقات المشرف (GraphQL) | OAuth / رمز الوصول | مثل REST ولكن مع الاستعلام المرن | | واجهة برمجة تطبيقات واجهة المتجر | رمز الوصول إلى واجهة المتجر | الميزات التي تواجه العملاء، والتجارة بلا رأس | | واجهة برمجة تطبيقات الخروج | الخروج رمز الوصول | تجارب الخروج المخصصة (Plus فقط) | | واجهة برمجة تطبيقات تطبيقات الدفع | بيانات اعتماد الشريك | تكامل بوابة الدفع | | وظائف واجهة برمجة التطبيقات | وحدات وسم | الخصومات المخصصة والشحن ومنطق التحقق |

واجهة برمجة تطبيقات المشرف

Admin API هي الواجهة الأساسية لإدارة بيانات المتجر. فهو يوفر الوصول إلى المنتجات والأوامر والعملاء والمخزون والوفاء والمزيد.

GraphQL مقابل REST:

يوصي Shopify باستخدام GraphQL Admin API للتطوير الجديد. تشمل الفوائد ما يلي:

• اطلب الحقول التي تحتاجها بالضبط (بدون جلب زائد)
• جلب الموارد ذات الصلة في طلب واحد
• مخطط مكتوب بقوة مع الاستبطان
• استخدام أفضل لحدود السعر (على أساس التكلفة بدلاً من الاعتماد على الطلب)

مثال GraphQL - جلب المنتجات:

query {
  products(first: 10) {
    edges {
      node {
        id
        title
        variants(first: 5) {
          edges {
            node {
              price
              inventoryQuantity
            }
          }
        }
      }
    }
  }
}

حدود السعر:

• واجهة برمجة تطبيقات GraphQL Admin: 1000 نقطة تكلفة في الثانية (كل حقل له تكلفة)
• REST Admin API: 40 طلبًا في الثانية (Basic/Shopify)، 80 (متقدم/Plus)
• واجهة برمجة تطبيقات واجهة المتجر: 100 نقطة تكلفة في الثانية

واجهة برمجة تطبيقات واجهة المتجر

تم تصميم Storefront API للتجارب التي تواجه العملاء. فهو يوفر وصولاً غير مصدق إلى المنتجات والمجموعات ووظائف سلة التسوق. استخدامه عند البناء:

• واجهات المحلات التجارية المخصصة (التجارة بلا رأس)
• تطبيقات الجوال
• أزرار الشراء المضمنة في المواقع الخارجية
• الحاجيات توصية المنتج

خطافات الويب

تقوم Webhooks بإعلام تطبيقك عند حدوث أحداث في متجر التاجر. بدلاً من استقصاء واجهة برمجة التطبيقات (API)، يرسل Shopify طلبات HTTP POST إلى نقطة النهاية الخاصة بك عندما تتغير البيانات.

** خطافات الويب الأساسية لمعظم التطبيقات: **

• orders/create -- تم تقديم طلب جديد
• orders/updated -- تم تغيير حالة الطلب
• products/update -- تم تعديل بيانات المنتج
• products/delete -- تمت إزالة المنتج
• app/uninstalled -- قام التاجر بإلغاء تثبيت تطبيقك
• shop/update -- تم تغيير إعدادات المتجر

أفضل ممارسات الرد التلقائي على الويب:

1. الرد سريعًا - إرجاع حالة 200 خلال 5 ثوانٍ؛ معالجة البيانات بشكل غير متزامن
2. التعامل مع التكرارات - قد يرسل Shopify نفس خطاف الويب عدة مرات؛ تنفيذ العجز
3. التحقق من التوقيعات -- التحقق من صحة رأس X-Shopify-Hmac-SHA256 لتأكيد الأصالة
4. تنفيذ منطق إعادة المحاولة -- إذا فشلت نقطة النهاية الخاصة بك، فسيقوم Shopify بإعادة المحاولة حتى 19 مرة خلال 48 ساعة
5. استخدم خطافات الويب الإلزامية -- قم بتسجيل app/uninstalled وcustomers/data_request وcustomers/redact وshop/redact للامتثال

إنشاء واجهة مستخدم للتطبيق باستخدام App Bridge وPolaris

Shopify جسر التطبيقات

يمكّن App Bridge عرض واجهة المستخدم الخاصة بتطبيقك داخل مسؤول Shopify. وهو يوفر:

• تكامل التنقل مع الشريط الجانبي للمشرف في Shopify
• مربعات حوار مشروطة وإشعارات الخبز المحمص وأشرطة التحميل
• منتقي الموارد لاختيار المنتجات والمجموعات والعملاء
• شريط العنوان مع الإجراءات الأولية والثانوية

نظام تصميم بولاريس

Polaris هي مكتبة مكونات React الخاصة بـ Shopify. وهو يوفر مكونات واجهة مستخدم معدة مسبقًا تتوافق مع لغة تصميم مسؤول Shopify:

• النماذج والأزرار وحقول الإدخال
• جداول البيانات وقوائم الموارد
• البطاقات واللافتات ومكونات التخطيط
• منتقي التاريخ، والمرشحات، وترقيم الصفحات

يضمن استخدام Polaris أن يبدو تطبيقك أصليًا داخل مشرف Shopify ويجتاز مراجعة التصميم.

وظائف شوبيفاي

تتيح لك وظائف Shopify تشغيل منطق الأعمال المخصص على البنية التحتية لـ Shopify باستخدام WebAssembly (Wasm). وهي تحل محل البرامج النصية القديمة لمحرر البرامج النصية وتعمل عند النقاط الرئيسية في تدفق التجارة:

• وظائف الخصم - منطق الخصم المخصص (BOGO، التسعير المتدرج، خصومات الحجم)
• وظائف الشحن - أسعار الشحن المخصصة وخيارات التسليم
• وظائف الدفع - إخفاء طرق الدفع أو إعادة ترتيبها عند الدفع
• وظائف التحقق - قواعد التحقق من سلة التسوق المخصصة والخروج
• وظائف التنفيذ - توجيه موقع التنفيذ المخصص

يتم تنفيذ الوظائف في أقل من 5 مللي ثانية ويتم تشغيلها على خوادم Shopify، مما يضمن عملها بغض النظر عن تقنية واجهة المتجر (السائل أو الهيدروجين أو الطرف الثالث).

عملية مراجعة التطبيق

يجب أن تجتاز التطبيقات العامة مراجعة Shopify قبل إدراجها في متجر التطبيقات. تقيم المراجعة:

المتطلبات الفنية:

• يجب أن يستخدم التطبيق أحدث الإصدارات من Shopify APIs
• تنفيذ OAuth الصحيح مع النطاقات الصحيحة
• HTTPS لجميع نقاط النهاية
• معالجات webhook الإلزامية للامتثال للقانون العام لحماية البيانات
• معالجة الأخطاء والتدهور الرشيق

متطلبات تجربة المستخدم:

• استخدم مكونات Polaris لواجهة المستخدم الإدارية
• تقديم تعليمات واضحة للإعداد والإعداد
• قم بتضمين رابط المساعدة/الدعم داخل التطبيق
• تصميم مستجيب لجميع أحجام شاشات الإدارة

متطلبات العمل:

• قائمة متجر التطبيقات واضحة ودقيقة
• شفافية التسعير والفواتير
• سياسة الخصوصية وشروط الخدمة
• دعم القناة بأوقات استجابة معقولة

أسباب الرفض الشائعة:

1. طلب نطاقات إذن API غير الضرورية
2. معالجات webhook الخاصة باللوائح العامة لحماية البيانات (GDPR) مفقودة
3. واجهة مستخدم ضعيفة لا تتبع إرشادات Polaris
4. عدم كفاية معالجة الأخطاء
5. تعطل الوظيفة أثناء المراجعة

تستغرق عملية المراجعة عادةً من 7 إلى 14 يوم عمل. معالجة التعليقات على الفور - يوفر Shopify إرشادات محددة بشأن التغييرات المطلوبة.

استراتيجيات تحقيق الدخل

يدعم Shopify العديد من نماذج الفوترة من خلال Billing API:

| نموذج | الأفضل لـ | مثال | |-------|----------|---------| | الاشتراك الشهري | ميزات التطبيق الأساسية | 9.99 دولارًا شهريًا للإصدار الأساسي، و29.99 دولارًا شهريًا للمحترفين | | الاشتراك السنوي | العملاء الملتزمون | 99 دولارًا سنويًا (خصم شهري) | | الفواتير على أساس الاستخدام | الاستهلاك المتغير | 0.01 دولار لكل مكالمة API أو بريد إلكتروني مرسل | | تهمة لمرة واحدة | الوصول مدى الحياة | 49.99 دولارًا للشراء لمرة واحدة | | فريميوم | اكتساب المستخدم | طبقة مجانية مع ترقيات مدفوعة |

نصائح للتسعير:

• يحصل Shopify على حصة إيرادات بنسبة 15% على أول مليون دولار أمريكي من الإيرادات، ثم 0% (وفقًا لشروط برنامج الشركاء الحالي)
• تقديم نسخة تجريبية مجانية (من 7 إلى 14 يومًا بشكل قياسي)
• إنشاء تمايز واضح في القيمة بين مستويات التسعير
• ضع في اعتبارك التسعير على أساس الاستخدام للتطبيقات ذات استهلاك الموارد المتغير

الاختبار وضمان الجودة

قبل إرسال تطبيقك للمراجعة:

1. اختبارات الوحدة - اختبار منطق العمل الأساسي بشكل منفصل
2. اختبارات التكامل - اختبار تفاعلات واجهة برمجة التطبيقات (API) مع متجر تطوير Shopify
3. اختبارات واجهة المستخدم - التحقق من عرض مكونات Polaris بشكل صحيح
4. اختبارات Webhook - التحقق من صحة معالجة webhook باستخدام حمولات الاختبار
5. اختبارات الأداء - تأكد من بقاء مكالمات واجهة برمجة التطبيقات (API) ضمن حدود المعدلات تحت التحميل
6. التدقيق الأمني - التحقق من وجود ثغرات أمنية في XSS وCSRF والحقن
7. اختبار تدفق OAuth - تحقق من التثبيت والمصادقة وإلغاء التثبيت

استخدم لوحة تحكم شريك Shopify لمحاكاة تكوينات المتجر المختلفة وأنواع الخطط.

تطوير التطبيقات الاحترافية

يتطلب إنشاء تطبيق Shopify خبرة في أنماط الأنظمة الأساسية المحددة لـ React وGraphQL وNode.js وShopify. توفر ECOSIRE خدمات تطوير تطبيقات Shopify احترافية للشركات التي تحتاج إلى وظائف مخصصة تتجاوز ما توفره التطبيقات الحالية.

سواء كنت بحاجة إلى تطبيق مخصص لمتجرك الخاص أو ترغب في إنشاء تطبيق عام لنظام Shopify البيئي، فإن فريق التطوير لدينا يتولى الهندسة المعمارية والتطوير والاختبار وتقديم App Store. كما نقدم أيضًا حلول التشغيل الآلي التي تتكامل مع واجهات برمجة التطبيقات وخطافات الويب الخاصة بـ Shopify.

اتصل بفريقنا لمناقشة مشروع تطوير تطبيق Shopify الخاص بك.

الوجبات السريعة الرئيسية

• يقدم Shopify ثلاثة أنواع من التطبيقات: عامة (متجر التطبيقات)، ومخصصة (متجر واحد)، ومسودة (تطوير)
• يوصى باستخدام GraphQL Admin API بدلاً من REST للتطوير الجديد
• تعمل خطافات الويب على تمكين معالجة الأحداث في الوقت الفعلي دون الاقتراع
• تقوم وظائف Shopify بتشغيل منطق الأعمال المخصص على البنية التحتية لـ Shopify عبر WebAssembly
• يضمن App Bridge وPolaris تكامل تطبيقك بسلاسة مع مسؤول Shopify
• تستغرق عملية مراجعة التطبيق من 7 إلى 14 يومًا ويتم تقييم الجودة الفنية وتجربة المستخدم ومتطلبات العمل
• تحقيق الدخل من خلال الاشتراكات، أو الفوترة على أساس الاستخدام، أو الرسوم لمرة واحدة عبر Billing API