वेबसाइट डिलीवरी मोड और हेडलेस एपीआई

आपकी सार्वजनिक वेबसाइट बिल्ट-इन स्टोरफ्रंट से, एक अलग डिप्लॉय किए गए फ्रंटएंड (जैसे Next.js ऐप या मोबाइल ऐप) से, या दोनों से आ सकती है। चुनाव एक एडमिन स्क्रीन में होता है और इसे बदलने के लिए कोई डिप्लॉयमेंट की आवश्यकता नहीं है।

इसे कहां सेट करें

साइट बिल्डर → वेबसाइट डिलीवरी (/admin/storefront/headless). स्क्रीन वर्तमान मोड, फ्रंटएंड पता, पहुंच की जांच और फ्रंटएंड को भेजे गए अंतिम कैश रिफ्रेश का समय दिखाती है।

पांच मोड

मोड	सार्वजनिक वेबसाइट	कब उपयोग करें
केवल बिल्ट-इन वेबसाइट	यह ऐप	अधिकतर स्टोर्स। एक सर्वर, कुछ अतिरिक्त डिप्लॉय करने की आवश्यकता नहीं।
बिल्ट-इन और अलग फ्रंटएंड	दोनों	आप एक नए फ्रंटएंड का प्रयास कर रहे हैं जबकि वर्तमान साइट बिक्री करती रहती है। ग्राहक ईमेल उस साइट का लिंक देता है जिसका ग्राहक ने उपयोग किया।
बिल्ट-इन पेज, फ्रंटएंड पर दुकान	यहां होम, पेज और ब्लॉग; फ्रंटएंड पर दुकान, कार्ट, चेकआउट और खाता	आपकी कंटेंट टीम पेज बिल्डर को बनाए रखती है जबकि दुकान तेज़ फ्रंटएंड पर जाती है।
केवल अलग फ्रंटएंड	फ्रंटएंड	फ्रंटएंड पूरी सार्वजनिक साइट है। यह होस्ट विजिटर्स को वहां रीडायरेक्ट करता है और केवल एडमिन पैनल और एपीआई को रखता है, जो सर्च इंजनों से छिपा होता है।
वेबसाइट बंद	कोई नहीं	एक बैक ऑफिस जिसमें कोई कैटलॉग नहीं है, उदाहरण के लिए एक निर्माता जो केवल ERP चला रहा है।

हर रीडायरेक्ट, जनरेटेड लिंक और ग्राहक ईमेल — पासवर्ड रीसेट, सत्यापन, ऑर्डर, कार्ट रिकवरी — उस मोड का पालन करते हैं जिसे आप चुनते हैं।

स्टोरफ्रंट API

बेस पता: /api/storefront/v1. यह तब तक बंद है जब तक आप एक ऐसा मोड नहीं चुनते जो एक फ्रंटेंड का उपयोग करता है।
संदर्भ: /api/storefront/v1/docs (OpenAPI)। यह एडमिन्स के लिए दृश्य है; आप इसे उसी स्क्रीन में सार्वजनिक बना सकते हैं।
यह साइट, थीम, पृष्ठ, मेनू, हेडर और फुटर, फॉर्म, कैटलॉग, कार्ट, चेकआउट, साइन-इन और ग्राहक पोर्टल को कवर करता है। वैकल्पिक मॉड्यूल जैसे ब्लॉग, समीक्षाएँ, बुकिंग और लॉयल्टी केवल तभी उत्तर देते हैं जब वे स्थापित होते हैं।
हर लिस्ट एंडपॉइंट पेजिनेटेड है (डिफ़ॉल्ट रूप से 24 प्रति पृष्ठ, 60 तक)।

एक अलग फ्रंटेंड पर सुरक्षित रूप से स्विच करना

फ्रंटेंड को डिप्लॉय करें और इसका HTTPS पता नोट करें।
चुनें बिल्ट-इन और अलग फ्रंटेंड पहले, फ्रंटेंड पता दर्ज करें और सहेजें। दोनों साइटें अब काम करती हैं।
फ्रंटेंड पर ब्राउज़िंग, कार्ट, चेकआउट और साइन-इन का परीक्षण करें।
किसी भी पुराने लिंक के लिए रीडायरेक्ट जोड़ें जो आकार बदलते हैं, एक प्रति पंक्ति।
तब ही केवल अलग फ्रंटेंड पर स्विच करें या पृष्ठ/शॉप विभाजन।
यदि आप Cloudflare का उपयोग करते हैं, तो ज़ोन आईडी और एक पर्ज टोकन जोड़ें ताकि फ्रंटेंड कैश हर सामग्री परिवर्तन के बाद साफ हो जाए।