इंटीग्रेशन बनाना

Yantra Bhavan के पास विक्रेता की ओर से काम करने वाले सॉफ्टवेयर के लिए एक सार्वजनिक, वर्ज़न वाला API है: वर्कशॉप का अपना ERP या MES, कोई आंतरिक स्क्रिप्ट, या कई विक्रेताओं के लिए आपका बनाया टूल। यह OAuth2 client credentials इस्तेमाल करता है, और हर रूट स्कोप वाला है।

क्रेडेंशियल पाना

क्रेडेंशियल विक्रेता जारी करता है, हम नहीं। Owner या Manager Slicer connections खोलकर Connect चुनता है, Third-party software चुनता है, और आपको वह एक-बार का एनरोलमेंट कोड देता है जो वहां दिखता है। आपका सॉफ्टवेयर उस कोड को एक बार भुनाकर क्लाइंट ID और सीक्रेट पाता है। क्रेडेंशियल उसी एक शॉप से बंधा होता है और उसी विक्रेता की तरह काम करता है जिसने इसे बनाया।

तीसरे पक्ष का क्रेडेंशियल क्या कर सकता है

• integration:parts:write
• integration:quotes:read
• integration:quotes:submit
• integration:rfq:read
• integration:files:read
• integration:orders:write — केवल तब जब विक्रेता Can create orders पर टिक करे; ऑर्डर API और वेबहुक देखें

स्लाइसर की प्रिंट-होस्ट कुंजी अलग प्रकार की होती है, जिसमें केवल integration:slice:upload होता है। यह स्लाइसर के लिए है, कोड के लिए नहीं — स्लाइस वापस भेजना देखें।

संदर्भ

• लाइव API रेफरेंस (OpenAPI), जिसमें हर सार्वजनिक रूट उसके स्कोप के साथ सूचीबद्ध है।
• कॉन्ट्रैक्ट पैकेज @yb/integration-contract में स्कोप, यूनिट, स्टेटस और त्रुटि के रूप हैं, और उसका README एनरोलमेंट, टोकन और हर रूट समझाता है। उसके साथ एक जनरेटेड Node क्लाइंट @yb/integration-sdk है। दोनों अभी किसी सार्वजनिक रजिस्ट्री पर नहीं हैं — पहुंच के लिए हमसे पूछें।

विक्रेता का डेटा संभालना

कोट में खरीदार का नाम और ईमेल शामिल होता है। इन्हें निजी डेटा मानें: केवल वही रखें जो आपके टूल को चाहिए, और विक्रेता द्वारा आपको डिसकनेक्ट करने पर उसे हटा दें। हम विक्रेताओं को इसके बारे में क्या बताते हैं, यह जानने के लिए आपकी मशीन से क्या बाहर जाता है देखें।