أوضاع تسليم الموقع وواجهة برمجة التطبيقات بدون رأس

يمكن أن يأتي موقعك العام من المتجر المدمج، أو من واجهة أمامية منفصلة تم نشرها (مثل تطبيق Next.js أو تطبيق موبايل)، أو من كلاهما. الخيار موجود في شاشة إدارة واحدة وتغييرها لا يحتاج إلى نشر.

أين يتم تعيينه

منشئ الموقع → تسليم الموقع (/admin/storefront/headless). تظهر الشاشة الوضع الحالي، عنوان الواجهة الأمامية، فحص الوصول ووقت آخر تحديث للذاكرة المؤقتة المرسل إلى الواجهة الأمامية.

الأوضاع الخمسة

الوضع	موقع عام	متى تستخدمه
موقع مدمج فقط	هذا التطبيق	معظم المتاجر. خادم واحد، لا شيء إضافي للنشر.
واجهة أمامية مدمجة ومنفصلة	كلاهما	أنت تجرب واجهة أمامية جديدة بينما يستمر الموقع الحالي في البيع. روابط البريد الإلكتروني للعملاء تشير إلى الموقع الذي استخدمه العميل.
صفحات مدمجة، متجر على الواجهة الأمامية	الصفحة الرئيسية، الصفحات والمدونة هنا؛ المتجر، السلة، الدفع والحساب على الواجهة الأمامية	فريق المحتوى لديك يحتفظ بمنشئ الصفحات بينما ينتقل المتجر إلى الواجهة الأمامية الأسرع.
واجهة أمامية منفصلة فقط	الواجهة الأمامية	الواجهة الأمامية هي الموقع العام بالكامل. هذا المضيف يعيد توجيه الزوار إلى هناك ويحتفظ فقط بلوحة الإدارة وواجهة برمجة التطبيقات، مخفية عن محركات البحث.
الموقع مغلق	لا شيء	مكتب خلفي بدون كتالوج، على سبيل المثال مصنع يعمل فقط على نظام ERP.

كل إعادة توجيه، رابط تم إنشاؤه وبريد إلكتروني للعميل — إعادة تعيين كلمة المرور، التحقق، الطلبات، استعادة السلة — يتبع الوضع الذي تختاره.

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

عنوان الأساس: /api/storefront/v1. إنه مغلق حتى تختار وضعًا يستخدم واجهة أمامية.
مرجع: /api/storefront/v1/docs (OpenAPI). إنه مرئي للمسؤولين؛ يمكنك جعله عامًا في نفس الشاشة.
يغطي الموقع، السمة، الصفحات، القوائم، الرأس والتذييل، النماذج، الكتالوج، السلة، الخروج، تسجيل الدخول وبوابة العملاء. الوحدات الاختيارية مثل المدونة، المراجعات، الحجوزات والولاء تجيب فقط عند تثبيتها.
كل نقطة نهاية قائمة يتم تقسيمها إلى صفحات (24 في الصفحة بشكل افتراضي، حتى 60).

التحويل إلى واجهة أمامية منفصلة بأمان

قم بنشر الواجهة الأمامية ودوّن عنوان HTTPS الخاص بها.
اختر واجهة أمامية مدمجة ومنفصلة أولاً، أدخل عنوان الواجهة الأمامية واحفظ. كلا الموقعين يعملان الآن.
اختبر التصفح، السلة، الخروج وتسجيل الدخول على الواجهة الأمامية.
أضف إعادة توجيه لأي روابط قديمة تتغير، واحدة في كل سطر.
فقط بعد ذلك انتقل إلى واجهة أمامية منفصلة فقط أو تقسيم الصفحات/المتجر.
إذا كنت تستخدم Cloudflare، أضف معرف المنطقة ورمز التطهير حتى يتم مسح ذاكرة التخزين المؤقت للواجهة الأمامية بعد كل تغيير في المحتوى.