नोट
इस पृष्ठ तक पहुंच के लिए प्राधिकरण की आवश्यकता होती है। आप साइन इन करने या निर्देशिकाएँ बदलने का प्रयास कर सकते हैं।
इस पृष्ठ तक पहुंच के लिए प्राधिकरण की आवश्यकता होती है। आप निर्देशिकाएँ बदलने का प्रयास कर सकते हैं।
कस्टम एपीआई बनाते समय, आपको एक समाधान का उपयोग करना चाहिए। यदि आप समाधानों से परिचित नहीं हैं, तो पहले समाधान बनाएँ पढ़ें.
आपका समाधान किसी प्रकाशक से संबद्ध होना चाहिए. प्रकाशक के पास इसके साथ एक विशिष्ट अनुकूलन उपसर्ग संबद्ध है। कस्टम API बनाते समय आपको एक अनुकूलन उपसर्ग का उपयोग करना चाहिए और यह उपसर्ग वही होना चाहिए जिसका उपयोग आपके समाधान के प्रकाशक द्वारा किया जाता है. निम्न निर्देश मान को sample अनुकूलन उपसर्ग के रूप में उपयोग करते हैं क्योंकि यह प्रकाशक के लिए एक सेट है.
महत्त्वपूर्ण
- कस्टम एपीआई बनाने के लिए अब एक बेहतर अनुभव है। आप प्लग-इन पंजीकरण उपकरण के भीतर एक डिज़ाइनर का उपयोग कर सकते हैं। अधिक जानकारी: प्लग-इन पंजीकरण टूल का उपयोग करके एक कस्टम एपीआई बनाएं
- कस्टम API बनाने से संबंधित कई फ़ील्ड को आपके द्वारा बनाने के बाद बदला नहीं जा सकता. शुरू करने से पहले आपको कस्टम एपीआई के डिज़ाइन की सावधानीपूर्वक योजना बनानी चाहिए। अगर आप बाद में तय करते हैं कि कस्टम API बनाने के बाद आपको चीज़ों को बदलने की ज़रूरत है, तो आपको मौजूदा रिकॉर्ड को मिटाने और कस्टम API को फिर से बनाने की आवश्यकता हो सकती है. उन स्तंभों के बारे में जानकारी की समीक्षा करें जिन्हें यहां बदला नहीं जा सकता: कस्टमएपीआई टेबल
एक कस्टम API रिकॉर्ड बनाएँ
अपने समाधान में, ड्रॉप-डाउन से नया और>अधिक>अन्य>कस्टम एपीआई चुनें.
अपने कस्टम API के गुण सेट करने के लिए फ़ील्ड संपादित करें. आपको निम्न फ़ील्ड्स के लिए मान सेट करना होगा. अधिक जानकारी के लिए, कस्टम API तालिका स्तंभ देखें
प्लग-इन बनाने से पहले आप प्लग-इन प्रकार के लिए मान सेट नहीं कर सकते. आप इसे बाद में बदल सकते हैं.
सहेजें चुनें. आपका फ़ॉर्म कुछ इस तरह दिखना चाहिए:
कोई भी अनुरोध पैरामीटर बनाएं
एक कस्टम एपीआई को पैरामीटर की आवश्यकता नहीं होती है। अपने तर्क के लिए आवश्यक डेटा पास करने के लिए जितने आवश्यक हैं उतने पैरामीटर बनाएं।
अपने समाधान में, ड्रॉप-डाउन से नया और>अधिक>अन्य>कस्टम API अनुरोध पैरामीटर चुनें.
अपने कस्टम API अनुरोध पैरामीटर के गुण सेट करने के लिए फ़ील्ड संपादित करें. अधिक जानकारी के लिए, CustomAPIRequestParameter तालिका स्तंभ देखें
सहेजें चुनें. आपका फॉर्म कुछ इस तरह दिखना चाहिए:
कोई भी प्रतिसाद गुण बनाएँ
एक कस्टम एपीआई जो एक कार्रवाई का प्रतिनिधित्व करता है, उसे प्रतिक्रिया गुणों की आवश्यकता नहीं होती है। एक फ़ंक्शन में कम से कम एक होना चाहिए। यदि ऑपरेशन सफल होता है, तो यह एक सफलता प्रतिक्रिया देता है। यदि यह विफल हो जाता है, तो यह एक त्रुटि लौटाता है। आपको अपने API द्वारा लौटाए जाने वाले किसी भी डेटा के लिए प्रतिक्रिया गुणों को परिभाषित करना चाहिए।
यदि केवल एक निकाय या EntityCollection प्रतिसाद गुण निर्धारित है, तो प्रतिसाद उस प्रकार का होता है. यदि कई गुण हैं, या एक साधारण प्रकार के एक या अधिक गुण हैं, तो एपीआई एक जटिल प्रकार लौटाता है जहां प्रत्येक प्रतिक्रिया संपत्ति उस जटिल प्रकार की संपत्ति है।
उदाहरण के लिए, यदि आपका कस्टम API अद्वितीय नाम है sample_CustomAPIExample, तो यह आपके द्वारा परिभाषित प्रत्येक प्रतिक्रिया गुण के लिए गुणों के साथ नामित sample_CustomAPIExampleResponse एक जटिल प्रकार लौटाता है।
अपने समाधान में, ड्रॉप-डाउन से नई अधिक>अन्य>>कस्टम API प्रतिक्रिया प्रॉपर्टी चुनें.
अपने कस्टम API रिस्पांस प्रॉपर्टी के गुण सेट करने के लिए फ़ील्ड संपादित करें. अधिक जानकारी के लिए, CustomAPIResponseProperty तालिका स्तंभ देखें
सहेजें चुनें. आपका फॉर्म कुछ इस तरह दिखना चाहिए:
सेवा दस्तावेज़ में परिणाम का निरीक्षण करें
यदि आपने अपने कस्टम एपीआई के लिए प्रॉपर्टी सेट IsPrivate नहीं की है, तो अब आप अनुरोध का उपयोग करके CSDLGET $metadata दस्तावेज़ से सेवा परिभाषा प्राप्त कर सकते हैं, यहां तक कि अपने ब्राउज़र से भी। यदि आपके परिवेश के लिए url है https://yourorg.crm.dynamics.com, तो आप $metadata पुनः प्राप्त करने के लिए इस URL को अपने ब्राउज़र पता फ़ील्ड में टाइप कर सकते हैं: https://yourorg.crm.dynamics.com/api/data/v9.1/$metadata.
कस्टम एपीआई का नाम खोजने के लिए परिणाम खोजें। उदाहरण के लिए, ऊपर दिए गए चरणों का उपयोग करके परिभाषित एपीआई इस तरह दिखता है:
<ComplexType Name="sample_CustomAPIExampleResponse">
<Property Name="StringProperty" Type="Edm.String" Unicode="false" />
</ComplexType>
<Action Name="sample_CustomAPIExample">
<Parameter Name="StringParameter" Type="Edm.String" Nullable="false" Unicode="false" />
<ReturnType Type="mscrm.sample_CustomAPIExampleResponse" Nullable="false" />
</Action>
अपने कस्टम एपीआई का परीक्षण करें
अपना कस्टम एपीआई बनाने के बाद आप इसे आज़मा सकते हैं। यहां तक कि अगर आपने मुख्य ऑपरेशन को परिभाषित करने के लिए प्लग-इन प्रकार सेट नहीं किया है, तो आप यह सत्यापित करने के लिए अभी इसका परीक्षण कर सकते हैं कि आप इसे सही ढंग से कॉल कर सकते हैं। कोई भी प्रतिसाद गुण अपना डिफ़ॉल्ट मान लौटाते हैं, जैसे कि शून्य. अधिक जानकारी: कस्टम एपीआई लागू करना।
कस्टम एपीआई प्लगइन प्रकार को अपडेट करें
कस्टम API के लिए प्लग-इन लिखने के तरीके के बारे में जानकारी के लिए, अपने कस्टम API के लिए प्लग-इन लिखना देखें.
अपनी असेंबली पंजीकृत करने के बाद, आपको अपने द्वारा बनाए गए कस्टम एपीआई के लिए प्लगइन प्रकार मान सेट करना होगा। यह एक लुकअप प्रॉपर्टी है, इसलिए आपको बस प्लग-इन टाइप ढूंढना होगा जो उस प्रकार का प्रतिनिधित्व करता है जब आपने असेंबली पंजीकृत की थी।
एक बार जब आप प्लगइन प्रकार सेट कर लेते हैं, तो आप यह सत्यापित करने के लिए अपने कस्टम एपीआई का परीक्षण कर सकते हैं कि सही परिणाम लौटाए गए हैं।
कस्टम एपीआई बनाने के अन्य तरीके
प्लगइन पंजीकरण उपकरण एक कस्टम एपीआई डिजाइनर प्रदान करता है। अधिक जानकारी: प्लग-इन पंजीकरण टूल का उपयोग करके एक कस्टम एपीआई बनाएं
आपके पास एक क्लाइंट एप्लिकेशन बनाने की आवश्यकताएं हो सकती हैं जो डिज़ाइनर के बाहर कस्टम एपीआई बनाने की अनुमति देता है। चूंकि कस्टम एपीआई के लिए डेटा तालिकाओं में संग्रहीत किया जाता है, इसलिए आप उन्हें कोड का उपयोग करके बना सकते हैं। अधिक जानकारी: कोड के साथ एक कस्टम एपीआई बनाएं।
समाधान फ़ाइलों को संपादित करके कस्टम एपीआई बनाकर आपकी एएलएम प्रक्रिया को बेहतर ढंग से पूरा किया जा सकता है। अधिक जानकारी: समाधान फ़ाइलों के साथ एक कस्टम API बनाएं.
इसे भी देखें
कस्टम API बनाएं और उनका उपयोग करें
प्लग-इन पंजीकरण टूल का उपयोग करके एक कस्टम एपीआई बनाएं
कोड के साथ एक कस्टम एपीआई बनाएं
समाधान फ़ाइलों के साथ एक कस्टम API बनाएं
अपने स्वयं के संदेश बनाएं