eBay को Claude से जोड़ना समझने के स्तर पर कठिन नहीं है। इसमें एक OAuth ऐप, चार मान और अनुमतियों की सूची है। मुश्किल यह है कि eBay इन मानों को दूसरे सभी मार्केटप्लेस से अलग नाम देता है, और एक फ़ील्ड ऐसी चीज़ माँगता है जो बिल्कुल URL जैसी दिखती है, लेकिन URL है नहीं।
चार मान, और eBay उन्हें क्या कहता है
App ID क्लाइंट ID है। Cert ID क्लाइंट सीक्रेट है। दोनों eBay डेवलपर पोर्टल में मेरा खाता → एप्लिकेशन कुंजियाँ के अंतर्गत मिलते हैं, और दोनों को बस कॉपी-पेस्ट करना है।
RuName वही है जिस पर लोग अटकते हैं, और नीचे इसके लिए अलग भाग है।
मार्केटप्लेस ID तय करती है कि आप किस eBay साइट पर काम कर रहे हैं, और इसे उस मार्केटप्लेस द्वारा समर्थित लोकेल से मेल खाना चाहिए। यह अधिकतर स्पष्ट होता है — जब तक कोई अपवाद सामने न आए। eBay निर्धारित करता है en-US मलेशिया और सिंगापुर के लिए, और यह ठीक वैसी जानकारी है जो किसी गाइड के बजाय त्रुटि से पता चलती है।
RuName एक नाम है, पता नहीं
डेवलपर पोर्टल में कुंजी सेट → उपयोगकर्ता टोकन → अपने एप्लिकेशन के ज़रिए टोकन प्राप्त करें पर जाएँ, और रीडायरेक्ट URL प्रविष्टि बनाएँ या खोलें। उस प्रविष्टि में “आपका प्राधिकरण स्वीकृति URL” उस क्लाइंट के कॉलबैक पते पर सेट करें जिसे आप जोड़ रहे हैं। Orkas इस्तेमाल करता है https://orkas.ai/api/connectors/oauth/dcr-callback, और इसके लिए आपके अपने सर्वर की ज़रूरत नहीं है।
फिर — और यही अहम चरण है — आप कॉपी करते हैं वह RuName जो eBay ने उस प्रविष्टि के लिए बनाया था। यह एक छोटी-सी स्ट्रिंग है जिसका अर्थ साफ़ नहीं होता, और जो आपके अभी दर्ज किए गए URL के पास दिखाई देती है। इसे माँगने वाला फ़ील्ड URL फ़ील्डों से घिरा है, इसलिए स्वाभाविक रूप से आप फिर से URL चिपकाना चाहते हैं। इससे अनुमति नहीं मिलती, और लौटने वाला त्रुटि संदेश इसकी वजह नहीं बताता।
सैंडबॉक्स कोई शॉर्टकट नहीं है
eBay एक सैंडबॉक्स चलाता है जिसके लिए केवल मुफ़्त डेवलपर खाते की ज़रूरत होती है, अच्छी स्थिति वाले विक्रेता खाते की नहीं। API की बनावट समझने के लिए यह सचमुच उपयोगी है। लेकिन आप वास्तव में जो चाहते हैं — अपनी लिस्टिंग और अपने ऑर्डर — उसके लिए यह उपयोगी नहीं है। सैंडबॉक्स का डेटा कृत्रिम होता है।
Orkas में नए कनेक्शन केवल प्रोडक्शन का उपयोग करते हैं। इसका मतलब है कि इस सेटअप का सबसे समय लेने वाला हिस्सा eBay Developers Program का आवेदन है — विक्रेता खाते, इन्वेंट्री, लिस्टिंग और ऑर्डर पूर्ति की अनुमतियों वाला ऐप और उसका Production Keyset — न कि वह क्लाइंट जिसे आप बाद में चुनते हैं। इसकी शुरुआत जल्दी करें। आधिकारिक अनुमति गाइड आवेदन लंबित रहने के दौरान पढ़ना उपयोगी है।
पढ़ना, लिखना नहीं है
कीसेट बन जाने के बाद, अनुमतियों की सूची तय करती है कि कनेक्शन वास्तव में किस काम के लिए है। पिछले सप्ताह क्या बिका, यह पूछना डेटा पढ़ने की क्रिया है। लिस्टिंग में संशोधन करना, इन्वेंट्री बदलना या किसी ऑर्डर को भेजा हुआ चिह्नित करना डेटा लिखने की क्रिया है, और इसके लिए ऐप पर संबंधित अनुमति-स्कोप चाहिए।
कई होस्ट की गई eBay-to-Claude सेवाएँ मूल रूप से केवल डेटा पढ़ने के लिए बनी हैं, और यह एक उचित उत्पाद है — बस यह वही उत्पाद नहीं है। आवेदन में मेहनत लगाने से पहले डेटा लिखने की सुविधा जाँच लें, क्योंकि दोनों स्थितियों में आवेदन एक जैसा ही है।
Orkas कनेक्टर आपकी अपनी मशीन से प्रोडक्शन Sell APIs के साथ काम करता है। क्रेडेंशियल किसी कॉन्फ़िग फ़ाइल या किसी और के सर्वर पर रहने के बजाय डिवाइस पर एन्क्रिप्ट किए जाते हैं। और लाइव खाते में कुछ भी लिखने वाला हर काम मॉडल की सावधानी पर निर्भर रहने के बजाय क्लाइंट में अनुमति माँगने वाले संदेश से होकर गुज़रता है।
जब कोई दूसरा विकल्प बेहतर हो
आपको केवल रिपोर्ट चाहिए: होस्ट किए गए कनेक्टर में कम सेटअप लगता है और कुछ इंस्टॉल नहीं करना पड़ता। आप चाहते हैं कि यह बिना निगरानी तय समय पर चलता रहे: यह एक डेस्कटॉप ऐप्लिकेशन है, इसलिए विंडो बंद करने पर यह रुक जाता है; इसके लिए सर्वर पर निर्धारित समय पर चलने वाला काम सही विकल्प है। आप अभी API सीख रहे हैं: सैंडबॉक्स और मुफ़्त डेवलपर खाते का उपयोग करें, और अभी किसी चीज़ को लाइव खाते से न जोड़ें।
यही कैटलॉग में Etsy, Walmart Marketplace, Amazon Seller Central, Shopify, WooCommerce और चीनी प्लेटफ़ॉर्म शामिल हैं, इसलिए हर स्टोरफ़्रंट के लिए क्रेडेंशियल सँभालने की मशक्कत फिर से शुरू नहीं होती। इससे जुड़े लेख Etsy और Shopify में उन दोनों के लिए यही विषय शामिल हैं।