Skip to main content
X API, स्थिरता बनाए रखते हुए बदलाव और विकास की सुविधा देने के लिए, एंडपॉइंट paths में version numbers का उपयोग करता है। हमारी वर्ज़निंग रणनीति को समझने से आपको integrations की योजना बनाने और नवीनतम बदलावों के साथ अद्यतन रहने में मदद मिलती है।

वर्तमान संस्करण

सभी नई परियोजनाओं के लिए X API v2 का उपयोग करें। सभी नई सुविधाएँ इसी में जारी की जाती हैं।

URL में संस्करण

संस्करण संख्या एंडपॉइंट के पाथ में दिखाई देती है:

ब्रेकिंग और नॉन-ब्रेकिंग बदलाव

ब्रेकिंग बदलाव (कोड अपडेट आवश्यक हैं)

ये बदलाव केवल major version bumps में होते हैं:
  • किसी एंडपॉइंट को हटाना
  • किसी response field को हटाना
  • किसी query parameter को हटाना
  • कोई नया required parameter जोड़ना
  • किसी field का data type बदलना
  • किसी field या resource का नाम बदलना
  • response codes या error types बदलना
  • authorization scopes में बदलाव करना

नॉन-ब्रेकिंग परिवर्तन (योगात्मक)

ये संस्करण में बदलाव किए बिना किसी भी समय हो सकते हैं:
  • नया एंडपॉइंट जोड़ना
  • नया वैकल्पिक parameter जोड़ना
  • response में नया फ़ील्ड जोड़ना
  • नए OAuth scopes जोड़ना
  • त्रुटि संदेश के टेक्स्ट में बदलाव करना
  • गोपनीयता/सुरक्षा कारणों से फ़ील्ड्स को null करना

रिलीज़ शेड्यूल


अप्रचलन नीति

जब हम कोई नया मुख्य संस्करण जारी करते हैं:
  1. अप्रचलन: पिछले संस्करण को अप्रचलित घोषित किया जाता है
  2. समर्थन अवधि: अप्रचलित संस्करण एक निर्धारित अवधि तक काम करता रहता है
  3. सेवानिवृत्ति: अप्रचलित संस्करण हटा दिया जाता है

परिभाषाएँ


जानकारी में रहें

बदलावों की जानकारी पाएं:

चेंजलॉग

सभी प्लेटफ़ॉर्म बदलाव और अपडेट।

फ़ोरम घोषणाएँ

महत्वपूर्ण बदलावों की सूचनाएँ।

@XDevelopers

प्लेटफ़ॉर्म समाचार और अपडेट।

न्यूज़लेटर

मासिक सारांश।

माइग्रेशन संसाधन

जब कोई नया संस्करण जारी होता है, तो हम ये उपलब्ध कराते हैं:
  • माइग्रेशन गाइड: चरण-दर-चरण अपग्रेड निर्देश
  • एंडपॉइंट मैपिंग: v1 से v2 के समकक्ष
  • डेटा फ़ॉर्मैट में बदलाव: ऑब्जेक्ट मॉडल में अंतर

माइग्रेशन का अवलोकन

वर्तमान माइग्रेशन मार्गदर्शन।

एंडपॉइंट मैप

v1 से v2 एंडपॉइंट मैपिंग।

सर्वोत्तम तरीके

v2 का उपयोग करें

नए प्रोजेक्ट नवीनतम संस्करण पर शुरू करें।

घोषणाओं पर नज़र रखें

चेंजलॉग और फ़ोरम अपडेट की सदस्यता लें।

बदलावों का परीक्षण करें

प्रोडक्शन में अपडेट करने से पहले डेवलपमेंट में परीक्षण करें।

माइग्रेशन की योजना बनाएँ

अपग्रेड करने के लिए अप्रचलन तक इंतज़ार न करें।