क्रेडेंशियल्स और एनवायरनमेंट्स#
अपने Visualizer SDK स्टोरफ्रंट के लिए क्रेडेंशियल्स कॉन्फ़िगर करें और, यदि आवश्यक हो, तो Product Import API के लिए भी। सार्वजनिक दस्तावेज़ पढ़ने से कोई क्रेडेंशियल नहीं बनता और न ही किसी शॉप तक पहुंच प्रदान की जाती है।
कौन सा क्रेडेंशियल कहाँ आता है?#
| एकीकरण | क्रेडेंशियल | यह कहाँ आता है |
|---|---|---|
| स्टोरफ्रंट SDK | Shop ID और Publishable Key | स्टोरफ्रंट SDK स्क्रिप्ट एट्रिब्यूट्स |
| Product Import API | Client ID और Client Secret | आपका बैकएंड या एक सुरक्षित सर्वर-साइड जॉब |
एक Publishable Key ब्राउज़र के लिए निर्धारित है। एक Client Secret आपके सर्वर पर ही रहना चाहिए। कभी भी इन्हें थीम, सार्वजनिक मार्कडाउन, क्लाइंट बंडल या सपोर्ट स्क्रीनशॉट में पेस्ट न करें।
क्रेडेंशियल्स प्राप्त करें और कॉन्फ़िगर करें#
मर्चेंट डैशबोर्ड खोलें, सही शॉप चुनें और SDK एकीकरण और सेटिंग्स की समीक्षा करें। Client ID और Client Secret के लिए ऑनबोर्डिंग निर्देशों का पालन करें।
Allowed Origins (CORS) कॉन्फ़िगर करें#
SDK का परीक्षण या प्रकाशन करने से पहले, सही शॉप के लिए डैशबोर्ड → सेटिंग्स खोलें और Allowed Origins (CORS) खोजें।
- उन स्टोरफ्रंट्स के ओरिजिन दर्ज करें जो SDK लोड करेंगे, अल्पविराम से अलग किए गए। उदाहरण के लिए:
https://example.com, https://www.example.com, https://shop.example.com। - प्रोटोकॉल और होस्टनेम का उपयोग करें, यदि लागू हो तो पोर्ट के साथ, पेज पाथ, क्वेरी स्ट्रिंग या फ्रैगमेंट के बिना। यदि आप SDK का परीक्षण वहां करते हैं, तो अपने प्रीव्यू या स्टेजिंग ओरिजिन को भी जोड़ें;
http://localhost:3000का उपयोग केवल तब करें जब वह आपका वास्तविक लोकल टेस्ट ओरिजिन हो। - सेव पर क्लिक करें, फिर स्टोरफ्रंट रीलोड करें और SDK का पुनः परीक्षण करें।
वास्तविक URL की जाँच करें जिसे ग्राहक देखते हैं: https://example.com और https://www.example.com अलग-अलग ओरिजिन हैं। एक सफल लोकल या प्रीव्यू टेस्ट यह स्थापित नहीं करता कि प्रकाशित ओरिजिन कॉन्फ़िगर किया गया है।
उदाहरण मानों को बदलें#
उदाहरणों में <SHOP_ID>, <PUBLISHABLE_KEY> और <YOUR_CLIENT_SECRET> जैसे प्लेसहोल्डर का उपयोग किया जाता है। इन्हें केवल निर्धारित एनवायरनमेंट में बदलें। HTML उदाहरण कोण ब्रैकेट्स को < और > के रूप में एनकोड कर सकते हैं; उस एनकोडिंग सहित पूरा प्लेसहोल्डर बदलें।
SDK और प्रोडक्ट इम्पोर्ट एनवायरनमेंट्स#
ब्राउज़र उसी शॉप के Shop ID और Publishable Key के साथ https://sdk.ideal.house/sdk.js लोड करता है। Product Import API अपने दस्तावेज़ीकृत सर्वर-साइड प्रमाणीकरण के साथ https://sdkapi.ideal.house का उपयोग जारी रखता है।
ऊपर वर्णित अनुसार अपने प्रीव्यू और प्रोडक्शन स्टोरफ्रंट ओरिजिन को अलग-अलग कॉन्फ़िगर करें। प्रकाशन से पहले तैयार टेस्ट उत्पादों का उपयोग करें, फिर लॉन्च चेकलिस्ट पूरी करें।