क्या आप जानते हैं कि कंटेंट डिलीवरी कॉमर्स एपीआई 3.7 की रिलीज के साथ हमने कस्टमाइज्ड कॉमर्स v14 की बॉक्स हेडलेस क्षमताओं में व्यापक सुधार किया है?
चूंकि सामग्री वितरण API पहले से ही कैटलॉग डेटा का समर्थन कर रहा था, इसलिए आप हमारे रेस्ट एपीआई का उपयोग करके उत्पादों को लाने में सक्षम थे। हमने कुछ बुनियादी वाणिज्य कार्यों का भी समर्थन किया जैसे बाजार, मूल्य आदि प्राप्त करना।
जब कस्टमाइज्ड कॉमर्स के लिए रेस्ट एपीआई की बात आती है, तो हमारे पास पहले से सर्विस एपीआई भी थी। यह एपीआई वाणिज्य संबंधी सभी सुविधाओं का समर्थन करता है जैसे उत्पाद, ग्राहक, कार्ट और ऑर्डर बनाना आदि। लेकिन इस एपीआई का इरादा एकीकरण उद्देश्यों के लिए है, भले ही इसका उपयोग हेडलेस परिदृश्यों के लिए किया जा सके।
https://docs.developers.optimizely.com/customized-commerce/v1.3.0-service-api-developer-guide/docs
लंबे समय से आप भागीदारों से प्रतिक्रिया स्पष्ट रही है, और हम आपकी आवश्यकताओं को समझते हैं और बाजार और रुझान कहां जा रहे हैं। आज हमें न केवल वेब, बल्कि अन्य चैनलों, जैसे मोबाइल ऐप की भी सेवा करने में सक्षम होने की आवश्यकता है। इसके अलावा, हमारे प्लेटफॉर्म पर अधिकांश नई ईकॉमर्स साइटें अपने फ्रंटएंड के लिए रिएक्ट जैसे जावास्क्रिप्ट फ्रेमवर्क का उपयोग कर रही हैं। लेकिन आपको एक भागीदार के रूप में पूर्ण ईकॉमर्स समर्थन के लिए हमेशा हमारे .Net APIs को अपने स्वयं के बाकी APIs में लपेटने की आवश्यकता होती है।
नया जारी किया गया कंटेंट डिलीवरी कॉमर्स एपीआई अब आपके लिए जरूरी सभी कॉमर्स से संबंधित हेडलेस एपीआई जोड़ता है। उपयोग में आसान है क्योंकि यह हमारे द्वारा पहले से प्राप्त सामग्री वितरण API का विस्तार करता है, और आप पहले से ही इससे परिचित हैं।
https://nuget.optimizely.com/package/?id=EPiServer.ContentDeliveryApi.Commerce
एपीआई अवलोकन
- कार्ट – बनाना, संशोधित करना, लाना, क्रय आदेश में बदलना
- ग्राहक – बनाएं, अपडेट करें, पासवर्ड सेट करें आदि
- सूची – SKU प्रति स्थिति प्राप्त करें
- बाजार – भाषा, मुद्रा, भुगतान आदि जैसी सभी सेटिंग्स के साथ बाजार प्राप्त करें
- भुगतान – भुगतान के तरीके प्राप्त करें, कार्ट को असाइन करें, भुगतान प्रक्रिया आदि
- मूल्य निर्धारण – एक SKU के लिए अलग-अलग मूल्य विकल्प प्राप्त करें
- गोदाम – उपलब्ध गोदामों को प्राप्त करें
- आदेश – खोज आदेश, अद्यतन आदेश आदि
स्थापना और विन्यास
1. नगेट पैकेज को यहां से इंस्टॉल करें:
https://nuget.optimizely.com/package/?id=EPiServer.ContentDeliveryApi.Commerce
2. एपीआई कॉन्फ़िगरेशन को अपने स्टार्टअप.सीएस में जोड़ें:
आपको services.AddCommerceApi सेट करने की आवश्यकता है(…) और services.AddOpenIDConnect(…) ।
उदाहरण कार्यान्वयन के लिए फाउंडेशन कोड देखें (हाँ, फाउंडेशन में एपीआई पहले से स्थापित है):
https://github.com/episerver/Foundation/blob/main/src/Foundation/Startup.cs
पोस्टमैन का उपयोग करके परीक्षण करें
आइए इसे पोस्टमैन के उपयोग से कार्य करते हुए देखें। हम अपने डेमो में कार्ट एपीआई का उपयोग मौजूदा एपीआई के साथ लॉगिन और वेरिएंट/एसकेयू लाने के लिए करेंगे।
- परिदृश्य ग्राहक के रूप में लॉगिन करना है
- एक उत्पाद खोजें (एसकेयू)
- इसे कार्ट में जोड़ें
- और फिर कार्ट को खरीद ऑर्डर में बदलें
एपीआई संदर्भ:
आप यहाँ v3 एपीआई संदर्भ पा सकते हैं:
https://docs.developers.optimizely.com/content-management-system/v1.5.0-content-delivery-api/reference/content-delivery-class-libraries-and-apis
1. लॉगिन करें और टोकन बनाएं:
डाक: https://{{siteurl}}/api/episerver/connect/token/
(देखना https://docs.developers.optimizely.com/content-management-system/v1.5.0-content-delivery-api/docs/api-authentication)
शरीर: अनुदान_प्रकार, क्लाइंट_आईडी, उपयोगकर्ता नाम, पासवर्ड
जवाब: एक्सेस टोकन
2. कार्ट में जोड़ने के लिए वैरिएंट प्राप्त करें
कार्ट में वैरिएंट जोड़ने के लिए आपको वैरिएंट/SKU के लिए गाइड की आवश्यकता होगी।
पाना: https://{{siteurl}}/api/episerver/v3.0/search/content/{{searchterm}}
(देखना https://docs.developers.optimizely.com/content-management-system/v1.5.0-content-delivery-api/docs/content-delivery-api-and-commerce)
हैडर: मूल्य के साथ प्राधिकरण “वाहक ”
जवाब: Json के रूप में संस्करण
इस उदाहरण में हम जोधपुर बूट (50__CatalogContent) के पहले वैरिएंट/SKU की आईडी का उपयोग करते हैं, जो मोसी फैशन फाउंडेशन साइट में उपलब्ध है।
हमें गाइड “8709E541-11F6-40D5-B488-800B961A1197” वापस मिलता है।
3. लाइन आइटम के साथ कार्ट बनाएं
कार्ट को अपडेट करते समय, पूरी कार्ट को पोस्ट करने की आवश्यकता होती है। उम्मीद है कि भविष्य के रिलीज में हम केवल एक लाइन आइटम को अपडेट करने में सक्षम होंगे।
डाक: https://{{siteurl}}/api/episerver/v3.0/me/carts
/me/carts/ एंडपॉइंट मेरे लिए एक कार्ट बनाएगा।
(देखना https://docs.developers.optimizely.com/content-management-system/v1.5.0-content-delivery-api/reference/cartapi_mepostby)
हैडर: मूल्य के साथ प्राधिकरण “वाहक ”
शरीर: कार्ट जेसन, नीचे छवि और कोड देखें। कार्ट बनाने के लिए नाम, मार्केट, करेंसी और शिपिंगमेथोडआईड अनिवार्य हैं, लेकिन इससे एक ऑर्डर बनाने के लिए हमें एक लाइनआइटम के साथ शिपमेंट की भी आवश्यकता होती है।
जवाब: हमारा नया कार्ट बनाया गया 
अब आपके पास उपरोक्त आईडी 9 वाला एक कार्ट है।
पोस्ट करने के लिए कार्ट जसन:
सामग्री आईडी जोधपुर बूट से है और शिपिंग विधि आईडी यूएस मानक शिपिंग से है। कोड जोधपुर बूट एसकेयू का भी है।
{
name: "Default", market: "US", currency: "USD",
"shipments": [
{
"lineItems": [
{
"quantity": 1,
"code": "SKU-39813617",
"contentId": "8709E541-11F6-40D5-B488-800B961A1197",
"placedPrice": 100
}
],
"shippingMethodId": "72457670-c12d-4270-9b31-1ad06743b7c0"
}
]
}
अब आप कार्ट को ऑर्डर प्रबंधन / CSR UI में ढूंढ सकते हैं: 
गाड़ी के लिए इस्तेमाल की जाने वाली शिपिंग विधि:
3ख। गाड़ी प्राप्त करें
जब आप इस कार्ट को प्रदर्शन या संशोधित करने के लिए फिर से लाना चाहते हैं। url में कार्टिड सेट करें।
पाना: https://{{siteurl}}/api/episerver/v3.0/me/carts/9
(देखना https://docs.developers.optimizely.com/content-management-system/v1.5.0-content-delivery-api/reference/cartapi_megetbycartid)
हैडर: मूल्य के साथ प्राधिकरण “वाहक ”
जवाब: Json के रूप में गाड़ी
4. कार्ट को ऑर्डर में बदलें
अब आपके पास आईडी 9 वाला एक कार्ट है, इसे अब खरीद आदेश में बदला जा सकता है।
यूआरएल में कार्टआईड सेट करें।
डाक: https://{{siteurl}}/api/episerver/v3.0/me/carts/9/converttoorder
(देखना https://docs.developers.optimizely.com/content-management-system/v1.5.0-content-delivery-api/reference/cartapi_meconverttoorderbycartid)
हैडर: मूल्य के साथ प्राधिकरण “वाहक ”
जवाब: हमारा नया आदेश बनाया गया
अब आपके पास आदेश संख्या PO9122 वाला क्रय आदेश है।
सारांश
यह अनुकूलित वाणिज्य के लिए REST कार्ट API का संक्षिप्त परिचय था। आशा है कि आपको यह उपयोगी लगा होगा और यह आपको कुछ इनपुट और विचार भी देता है कि उपलब्ध अन्य नए एपीआई का उपयोग कैसे करें।
प्रतिक्रिया?
कृपया एक टिप्पणी छोड़ दें, या हमारे फीडबैक पोर्टल में किसी भी प्रतिक्रिया और सुधार के सुझावों को बेझिझक पोस्ट करें:
https://feedback.optimizely.com/?project=COM
मई 25, 2023
2023-05-25 22:26:25
#कसटमइजड #कमरस #म #बहतर #हडलस #करयकषमत
