वर्शन

इस गाइड में बताया गया है कि Merchant API, अपने अलग-अलग वर्शन के लाइफ़साइकल, रिलीज़, और वर्शन को कैसे मैनेज करता है.

वर्शनिंग स्कीम

Merchant API, सब-एपीआई लेवल पर वर्शनिंग की रणनीति का इस्तेमाल करता है. इसका मतलब है कि Merchant API के अलग-अलग कॉम्पोनेंट या सेवाओं के वर्शन का लाइफ़साइकल अलग-अलग होगा.

वर्शन फ़ॉर्मैट और प्रज़ेंटेशन

• सब-एपीआई के स्टेबल वर्शन: अगर कोई सब-एपीआई स्टेबल वर्शन में है, तो उसके सभी तरीकों के लिए भी स्टेबल वर्शन उपलब्ध होता है. स्टेबल सब-एपीआई वर्शन को vX के तौर पर दिखाया जाता है (उदाहरण के लिए, v1, v2). ये प्रॉडक्शन के लिए तैयार मुख्य वर्शन हैं.

• सब-एपीआई के ऐल्फ़ा वर्शन: अगर कोई सब-एपीआई ऐल्फ़ा वर्शन में है, तो उसके सभी तरीकों के लिए भी ऐल्फ़ा वर्शन का इस्तेमाल किया जाता है. ऐल्फ़ा सब-एपीआई वर्शन को vXalpha के तौर पर दिखाया जाता है (उदाहरण के लिए, v1alpha, v2alpha). ये रिलीज़ होने से पहले इस्तेमाल करने के लिए उपलब्ध, एक्सपेरिमेंटल वर्शन हैं. इन्हें टेस्ट करने और तेज़ी से बदलाव करने के लिए बनाया गया है. ऐल्फ़ा वर्शन के साथ, स्थिरता की कोई गारंटी नहीं मिलती. साथ ही, यह भी नहीं बताया जाता कि ये वर्शन कब तक उपलब्ध रहेंगे. अल्फा वर्शन को 30 दिन की सूचना अवधि के साथ बदला या बंद किया जा सकता है.

वर्शन के परिवर्तन

• ऐप्लिकेशन के वर्शन में बड़े बदलाव (उदाहरण के लिए, v1 से v2): ये सिग्नल, ऐप्लिकेशन के पुराने वर्शन के साथ काम नहीं करने वाले और ऐप्लिकेशन के काम करने के तरीके में बदलाव करने वाले बदलावों के बारे में बताते हैं. इन बदलावों के लिए, डेवलपर को कार्रवाई करनी पड़ती है. सिर्फ़ स्टेबल सब-एपीआई के बदलावों के लिए, नया वर्शन नंबर होगा. उदाहरण के लिए, v1 से v2.

• छोटे बदलाव: पुराने सिस्टम के साथ काम करने वाले वर्शन में जोड़े गए फ़ीचर या गड़बड़ियों को ठीक करने के तरीके को, मौजूदा मेजर वर्शन में किए गए बदलावों के तौर पर दिखाया जाता है. ऐसे बदलावों के बारे में, उस खास वर्शन के रिलीज़ नोट में बताया जाएगा. किसी सब-एपीआई में ऐसे बदलाव जो काम करने में रुकावट नहीं डालते, उन्हें नए स्टेबल वर्शन के अल्फ़ा चैनल पर या सीधे नए स्टेबल वर्शन पर रिलीज़ किया जाएगा.

डूबता सूरज

हम समय-समय पर, Merchant Center के पुराने सब-एपीआई वर्शन बंद कर देते हैं. हम स्थिर मेजर वर्शन (vX) के लिए, बंद होने की 12 महीने की विंडो देने का वादा करते हैं. यह विंडो, बंद होने के आधिकारिक एलान से शुरू होगी.

उदाहरण के लिए, अगर हम 15 जनवरी, 2026 को प्रॉडक्ट सब-एपीआई के वर्शन 1 को बंद कर देते हैं, तो वह 15 जनवरी, 2027 से पहले बंद नहीं होगा. इस तारीख के बाद, सब-एपीआई का पुराना वर्शन इस्तेमाल के लिए उपलब्ध नहीं होगा.

सब-एपीआई का वर्शन और लाइफ़साइकल स्टेटस

यहां दी गई टेबल में, Merchant API के हर सब-एपीआई के नए वर्शन की सूची दी गई है:

सबसे सही तरीके

• नए वर्शन, बड़े अपडेट, और सुधारों के बारे में जानने के लिए, रिलीज़ नोट और नए अपडेट को नियमित तौर पर देखें. साथ ही, सब-एपीआई के लॉन्च और बंद होने की सूचनाएं भी देखें.
• अगर किसी सब-एपीआई के दो या उससे ज़्यादा स्टेबल वर्शन हैं, तो हमारा सुझाव है कि आप हमेशा सबसे नए वर्शन का इस्तेमाल करें.
• अपने ऐप्लिकेशन को इस तरह डिज़ाइन करें कि वह सब-एपीआई की अलग-अलग गड़बड़ियों को आसानी से मैनेज कर सके. इनमें नेटवर्क से जुड़ी समस्याएं, दर की सीमाएं, और गड़बड़ी के नए कोड या मैसेज शामिल हैं. ये सब-एपीआई के नए वर्शन के साथ उपलब्ध हो सकते हैं.
• अपग्रेड की योजना बनाने के लिए, किसी सब-एपीआई वर्शन के बंद होने का इंतज़ार न करें. नए वर्शन उपलब्ध होते ही, उनका आकलन और जांच करना शुरू करें.
• किसी सुविधा के लिए अनुरोध करने या किसी सब-एपीआई के रोडमैप के बारे में अपनी समस्याओं के बारे में बताने के लिए, हमसे सवाल पूछें या सुझाव/राय दें. तकनीकी सहायता के लिए, Merchant API टीम से संपर्क करने का तरीका जानने के लिए, Merchant API से जुड़ी मदद पाएं लेख पढ़ें.