# मर्चेंडाइज API और इंटीग्रेशन अनुबंध | MerchandAise

- slug: developers-api-integrations
- locale: hi
- localeResolved: hi
- canonical: https://www.merchandaise.com/hi/developers/api-integrations

असिस्टेंट टूलिंग, कम्युनिटी एम्बेड, सप्लायर ऑपरेशन और एंटरप्राइज़ आइडेंटिटी के लिए MerchandAise अनुबंधों का अन्वेषण करें, स्पष्ट सार्वजनिक और संरक्षित एक्सेस सीमाओं के साथ।

## सत्य का एकमात्र स्रोत बनाए रखें
एक इंटीग्रेशन को MerchandAise वर्कफ़्लो का विस्तार करना चाहिए, न कि उसे विभाजित (fork) करना चाहिए। वेबसाइट, एम्बेड, सप्लायर, एंटरप्राइज़ और भविष्य की असिस्टेंट सतहों को एक ही वर्शन वाले डिज़ाइन, कॉमर्स इंटेंट, कोट, अनुमोदन और ऑर्डर स्टेट को पढ़ना और अपडेट करना होगा।
जहां MerchandAise खरीदार के लेनदेन को प्रोसेस करता है, वहीं Hutter Products GmbH, MerchandAise ब्रांड के तहत अनुबंधित विक्रेता और मर्चेंट ऑफ़ रिकॉर्ड है। सप्लायर की पहचान और संपर्क विवरण गोपनीय रहते हैं, सिवाय इसके जहां प्रकटीकरण आवश्यक हो, और उत्पादन के लिए अभी भी डिजिटल-प्रूफ और वास्तविक-नमूने के अनुमोदन की आवश्यकता होती है।

## API और इंटीग्रेशन सतहें
- **असिस्टेंट टूलिंग API दस्तावेज़:** डिज़ाइन सत्रों और इंटीग्रेशन समीक्षा के लिए वर्तमान असिस्टेंट और टूलिंग एंडपॉइंट्स का अन्वेषण करें। यह सार्वजनिक संदर्भ कोट करने या ऑर्डर देने का अज्ञात अधिकार नहीं देता है। Human guide: असिस्टेंट टूलिंग दस्तावेज़ खोलें (/hi/developers/api-integrations). Machine-readable contract: असिस्टेंट टूलिंग OpenAPI JSON (/api/docs/openapi.json). Access: public. असिस्टेंट और टूलिंग API के लिए सार्वजनिक संदर्भ। उत्पादन एक्सेस और ऑर्डर-प्रभावित संचालन के लिए अभी भी लागू प्राधिकरण की आवश्यकता होती है। Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#api-docs.
- **कम्युनिटी एम्बेड API:** निहित वर्कफ़्लो को दोबारा बनाए बिना, स्थानीयकृत क्लब, कम्युनिटी या स्टोरफ़्रंट अनुभवों को MerchandAise-स्वामित्व वाले डिज़ाइन और कॉमर्स हैंडऑफ़ से कनेक्ट करें। Human guide: कम्युनिटी इंटीग्रेशन गाइड की समीक्षा करें (/hi/developers/api-integrations#community-integrations). Machine-readable contract: कम्युनिटी OpenAPI JSON (/api/v1/community/public/openapi/v1). Access: public. स्टोरफ़्रंट एम्बेड, कम्युनिटी डिस्कवरी और स्थानीयता-जागरूक हैंडऑफ़ के लिए सार्वजनिक वर्शन वाला अनुबंध। Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#community-integrations.
- **सप्लायर API:** सप्लायर संबंध और एक्सेस मॉडल योग्य होने के बाद अनुमोदित सप्लायर्स को ऑनबोर्डिंग, कैटलॉग, कोट और फ़ुलफ़िलमेंट ऑपरेशन्स से कनेक्ट करें। Human guide: सप्लायर इंटीग्रेशन गाइड की समीक्षा करें (/hi/developers/api-integrations#supplier-integrations). Machine-readable contract: सप्लायर OpenAPI JSON (/api/v1/supplier/openapi/v1). Access: public. योजना और क्लाइंट जनरेशन के लिए सार्वजनिक अनुबंध। परिचालन सप्लायर एक्सेस अनुमतियों के अधीन रहता है। Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#supplier-integrations.
- **एंटरप्राइज़ आइडेंटिटी API:** अनुमोदित कंपनी मर्चेंडाइज प्रोग्राम्स और नियंत्रित रोलआउट्स के लिए SSO, SCIM प्रोविज़निंग और ऑडिट-तैयार आइडेंटिटी फ़्लो की योजना बनाएं। Human guide: एंटरप्राइज़ इंटीग्रेशन गाइड की समीक्षा करें (/hi/developers/api-integrations#enterprise-integrations). Machine-readable contract: एंटरप्राइज़ आइडेंटिटी OpenAPI JSON (/api/v1/enterprise/identity/openapi/v1). Access: protected. अनुमोदित एंटरप्राइज़ वर्कस्पेस के लिए संरक्षित अनुबंध; इस एंडपॉइंट का उपयोग करने से पहले एक्सेस का अनुरोध करें। Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#enterprise-integrations.

## कोड से पहले अनुबंध चुनें
- **Step 1: उपयोगकर्ता यात्रा (यूज़र जर्नी) का मानचित्र बनाएं:** तय करें कि वर्कफ़्लो में कौन और कहां प्रवेश करता है: एक एम्बेडेड स्टोरफ़्रंट में खरीदार, एक अनुमोदित सप्लायर, एक एंटरप्राइज़ उपयोगकर्ता, या स्पष्ट प्राधिकरण के साथ काम करने वाला एक असिस्टेंट।
- **Step 2: एक्सेस सीमा की पुष्टि करें:** मूल्यांकन और क्लाइंट जनरेशन के लिए सार्वजनिक अनुबंधों का उपयोग करें, फिर कार्यान्वयन से पहले क्रेडेंशियल, स्कोप, वातावरण, कॉलबैक और संरक्षित एंडपॉइंट्स की पुष्टि करें।
- **Step 3: स्टेट निरंतरता सिद्ध करें:** परीक्षण करें कि रीप्रयास और रोलबैक पथों सहित इंटीग्रेशन में डिज़ाइन, कोट, अनुमोदन, त्रुटियां और ऑर्डर हैंडऑफ़ वर्शन-वर्तमान बने रहें।

## प्रत्येक इंटीग्रेशन को क्या संरक्षित करना चाहिए
- **एक वर्शन वाला स्टेट:** डिज़ाइन, कॉमर्स इंटेंट, सप्लायर-समर्थित कोट, अनुमोदन और ऑर्डर स्थिति जुड़े रहते हैं। पुराने परिवर्तनों से एक दृश्यमान री-कोट या समीक्षा स्थिति शुरू होनी चाहिए।
- **वाणिज्यिक और सप्लायर गोपनीयता:** MerchandAise खरीदार-सामने वाला मर्चेंट और सहायता स्वामी बना रहता है। सप्लायर की पहचान, संपर्क और आंतरिक डेटा सार्वजनिक इंटीग्रेशन के माध्यम से उजागर नहीं किए जाते हैं।
- **उत्पादन से पहले अनुमोदन:** एक उत्पाद-मूल 3D दृश्य और डिजिटल प्रूफ निर्णय का समर्थन करते हैं, लेकिन वे बड़े पैमाने पर उत्पादन से पहले आवश्यक वास्तविक उत्पादन नमूने की जगह नहीं लेते हैं।

## उत्पादन ट्रैफ़िक से पहले
एक प्रकाशित OpenAPI फ़ाइल एक योजना बनाने की सतह है, न कि अज्ञात उत्पादन एक्सेस का वादा। हम लाइव होने से पहले वातावरण, क्रेडेंशियल, विफलता हैंडलिंग और परिचालन स्वामित्व की समीक्षा करते हैं।
- **एक्सेस और वातावरण:** अनुबंध संस्करण, अनुमोदित वर्कस्पेस, प्रमाणीकरण स्कोप, सैनबॉक्स, उत्पादन क्रेडेंशियल और कॉलबैक गंतव्यों की पुष्टि करें।
- **विफलता और रिकवरी:** रिलीज़ से पहले रीप्रयास, आइडोटेंसी, टाइमआउट, ग्राहक-दृश्य त्रुटियां, ऑब्जर्वेबिलिटी, सहायता स्वामित्व और रोलबैक को परिभाषित करें।
- **एंड-टू-एंड साक्ष्य:** प्रवेश और स्टेट म्यूटेशन से लेकर कोट, अनुमोदन, हैंडऑफ़ और रिकवरी व्यवहार तक स्टेजिंग में इच्छित यात्रा को सत्यापित करें।

## अक्सर पूछे जाने वाले प्रश्न
- **मुझे किस इंटीग्रेशन सतह से शुरुआत करनी चाहिए?:** व्यक्ति और स्टेट संक्रमण से शुरुआत करें। खरीदार-सामने वाले क्लब या कम्युनिटी यात्राओं के लिए कम्युनिटी एम्बेड का उपयोग करें, अनुमोदित आपूर्ति-पक्ष वर्कफ़्लो के लिए सप्लायर ऑपरेशन्स का, SSO और SCIM के लिए एंटरप्राइज़ आइडेंटिटी का, और स्पष्ट रूप से अधिकृत AI-नेतृत्व वाले फ़्लो के लिए केवल असिस्टेंट टूलिंग का उपयोग करें।
- **क्या सार्वजनिक अनुबंध का मतलब सार्वजनिक उत्पादन एक्सेस है?:** नहीं। एक सार्वजनिक OpenAPI अनुबंध खोज, आर्किटेक्चर समीक्षा और क्लाइंट जनरेशन का समर्थन करता है। उत्पादन क्रेडेंशियल, राइट ऑपरेशन, सप्लायर वर्कफ़्लो, एंटरप्राइज़ आइडेंटिटी और असिस्टेंट निष्पादन के लिए अभी भी एक अनुमोदित वर्कस्पेस और स्कोप किए गए प्राधिकरण की आवश्यकता हो सकती है।
- **क्या कोई इंटीग्रेशन सप्लायर्स को उजागर कर सकता है या अनुमोδनों को बायपास कर सकता है?:** नहीं। सप्लायर की पहचान और संपर्क विवरण गोपनीय रहते हैं, सिवाय इसके जहां प्रकटीकरण आवश्यक हो, MerchandAise खरीदार के रिश्ते का मालिक है, और ऑर्डर-प्रभावित कार्रवाइयों को कॉन्फ़िगर किए गए अनुमोदन और वास्तविक-नमूने के द्वारों को संरक्षित करना चाहिए।

## हमें वर्कफ़्लो लाएं, तैयार आर्किटेक्चर नहीं।
हमें बताएं कि इंटीग्रेशन का उपयोग कौन करेगा, उन्हें किस स्टेट को पढ़ने या बदलने की आवश्यकता है, और अनुभव कहां रहेगा। हम आपके साथ अनुबंध, एक्सेस मॉडल और सबसे सुरक्षित रोलआउट पथ का मानचित्र तैयार करेंगे।
- **एक इंटीग्रेशन की योजना बनाएं:** /hi/contact?intent=api-integration-review
- **AI एजेंटों और MCP का अन्वेषण करें:** /hi/developers/ai-agents-mcp