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

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

संस्करणस्थितिविवरण
v2वर्तमानआधुनिक एंडपॉइंट, लचीला मूल्य निर्धारण, सभी नई सुविधाएँ
v1.1लीगेसीसीमित समर्थन, बहुत कम अपडेट
Enterpriseउपलब्धसमर्पित समर्थन के साथ उच्च-वॉल्यूम ऐक्सेस
सभी नई परियोजनाओं के लिए X API v2 का उपयोग करें। सभी नई सुविधाएँ इसी में जारी की जाती हैं।

​
URL में संस्करण

संस्करण संख्या एंडपॉइंट के पाथ में दिखाई देती है: 
https://api.x.com/2/tweets
                   ^
                   version

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

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

ये बदलाव केवल 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 का उपयोग करें

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

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

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

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

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

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

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