मुख्य सामग्री पर जाएं
X API v2 का नवीनतम संस्करण एक बड़ा बदलाव है। इसलिए, हमने इस माइग्रेशन अनुभाग को कुछ भागों में बाँटा है:

X API v2 क्या है?

X API v2 अब मुख्य X API है, और अब उत्पाद निवेश और नवाचार का केंद्र यही है। हमने डेवलपर्स के साथ मिलकर X API की अगली पीढ़ी तैयार की है, ताकि हमारे विविध डेवलपर समुदाय की ज़रूरतों को बेहतर ढंग से पूरा किया जा सके। डेवलपर्स से मिले फ़ीडबैक के आधार on, हमने API को फिर से बनाया है, ताकि ज़रूरतों की अधिक व्यापक शृंखला को बेहतर ढंग से पूरा किया जा सके, नई सुविधाएँ और endpoints जोड़े जा सकें, और डेवलपर अनुभव को बेहतर बनाया जा सके। X API v2 अब मुख्य X API है, और अब उत्पाद निवेश और नवाचार का केंद्र यही है। पिछले कुछ वर्षों में, हमने डेवलपर्स के साथ मिलकर API को फिर से बनाया, ताकि ज़रूरतों की अधिक व्यापक शृंखला को बेहतर ढंग से पूरा किया जा सके, नई सुविधाएँ और endpoints जोड़े जा सकें, और डेवलपर अनुभव को बेहतर बनाया जा सके। हम एक खुला डेवलपर प्लेटफ़ॉर्म बनाते रहने के लिए प्रतिबद्ध हैं, और यह देखने के लिए उत्साहित हैं कि आप X API v2 के साथ क्या बनाते हैं।

माइग्रेट क्यों करें?

X API v2 को एक आधुनिक और अधिक टिकाऊ आधार पर बनाया गया है। इसमें मानक v1.1 और enterprise उत्पादों के लिए बेहतर प्रतिस्थापन एंडपॉइंट्स के साथ-साथ बिल्कुल नई कार्यक्षमताएँ भी शामिल हैं। हम legacy APIs (v1.1 और enterprise) के ग्राहकों को दृढ़ता से प्रोत्साहित करते हैं कि वे v2 पर माइग्रेट करना शुरू करें, क्योंकि अंततः हमारा इन्हें अप्रचलित करने का इरादा है। सार्वजनिक बातचीत को सुनने और उसका विश्लेषण करने, X पर लोगों से जुड़ने, और नवाचार करने के लिए X API का उपयोग करें। इस अनुभाग में, हम एंडपॉइंट्स और कार्यक्षमता पर चर्चा करेंगे।

V2 एंडपॉइंट्स

आप नीचे दी गई गाइड के माध्यम से v2 एंडपॉइंट्स की पूरी सूची और उनके pre-v2 समकक्ष देख सकते हैं: हालाँकि X API v2 में अधिकांश एंडपॉइंट्स पुराने एंडपॉइंट्स के विकल्प हैं, हमने कई नए एंडपॉइंट्स भी पेश किए हैं। यहाँ कुछ नए एंडपॉइंट्स के उदाहरण दिए गए हैं, जिन्हें हमने v2 में जारी किया है:
  • Spaces endpoints, ताकि लोग X Spaces का बेहतर उपयोग कर सकें और डेवलपर्स ऑडियो बातचीत के भविष्य को आकार देने में मदद कर सकें।
  • Hide replies, जो आपको ऐसे टूल बनाने की सुविधा देता है, जो अपमानजनक, ध्यान भटकाने वाले या भ्रामक जवाबों के प्रभाव को बड़े पैमाने पर सीमित करने में मदद करते हैं।
  • नए सूचियों के एंडपॉइंट्स, जो आपको सूचियों को pin और unpin करने या किसी व्यक्ति की pin की गई सूचियों को देखने की सुविधा देते हैं।
  • नए batch compliance endpoints, जो आपको यह सुनिश्चित करने की सुविधा देते हैं कि आपका संग्रहीत उपयोगकर्ता और Tweet डेटा अनुपालन में है।

नई सुविधाएँ

X API v2 में नई सुविधाएँ भी शामिल हैं, जो आपको X API से अधिक लाभ प्राप्त करने में मदद करेंगी। इनमें से कई नई चीज़ें आपकी प्रतिक्रिया के आधार पर विकसित की गई हैं, और इनमें कुछ ऐसी सुविधाएँ भी शामिल हैं जो पहले केवल एंटरप्राइज़ ग्राहकों के लिए उपलब्ध थीं। API में किए गए कुछ सुधार इस प्रकार हैं:

नए और अपडेट किए गए रिस्पॉन्स ऑब्जेक्ट्स के बारे में जानें

निम्नलिखित छह डेटा ऑब्जेक्ट v2 endpoints के साथ उपलब्ध हैं: फ़ील्ड्स और expansions का उपयोग कैसे करें के बारे में और जानें।

यह चुनने की सुविधा कि आपको कौन-से ऑब्जेक्ट और फ़ील्ड्स मिलें

किसी GET endpoint पर अनुरोध करने पर, आपको उस endpoint से संबंधित प्राथमिक data object मिलेगा, जिसमें डिफ़ॉल्ट फ़ील्ड्स का एक सेट शामिल होता है। उदाहरण के लिए, Tweet object डिफ़ॉल्ट रूप से id और text फ़ील्ड्स देता है। अगर आप अपने अनुरोध के साथ अतिरिक्त फ़ील्ड्स पाना चाहते हैं, तो आपको फ़ील्ड्स और expansions पैरामीटर का उपयोग करना होगा। expansions पैरामीटर आपको संबंधित data object, जैसे किसी user का pinned Tweet या media object, प्राप्त करने देता है, जबकि field operators आपको लौटाए गए objects में डिफ़ॉल्ट से आगे के विशिष्ट फ़ील्ड्स का अनुरोध करने की सुविधा देते हैं। यहाँ expansions की पूरी सूची दी गई है, जिनका अनुरोध आप अलग-अलग X API v2 endpoints के साथ कर सकते हैं: फ़ील्ड्स और expansions का उपयोग कैसे करें के बारे में और जानें।

Tweet, उपयोगकर्ता, Spaces, और मीडिया ऑब्जेक्ट में अब नए मेट्रिक्स उपलब्ध हैं

अब Tweet, उपयोगकर्ता, Spaces, सूचियों और मीडिया ऑब्जेक्ट में अधिक मेट्रिक्स उपलब्ध हैं। इनमें सार्वजनिक और निजी, दोनों तरह के मेट्रिक्स शामिल हैं, और कुछ मेट्रिक्स को Tweet ads के लिए ऑर्गेनिक या प्रमोटेड कॉन्टेक्स्ट के अनुसार विभाजित किया जा सकता है। उपलब्ध मेट्रिक्स के बारे में और जानें।

Tweets संपादित करें

X API v2 endpoints संपादित किए गए Tweet का मेटाडेटा प्रदान करते हैं। Tweets संपादित करें सुविधा को पहली बार 1 सितंबर, 2022 को X कर्मचारियों के बीच परीक्षण के लिए पेश किया गया था। उस तारीख से, पात्र Tweets को 30 मिनट तक और अधिकतम 5 बार संपादित किया जा सकता है। Edit Tweets के बारे में और जानें। X API v2 का उपयोग करके, डेवलपर यह पता कर सकता है:
  • क्या कोई Tweet बनाए जाने के समय संपादन के लिए पात्र था। कुछ Tweets, जैसे polls वाले या scheduled Tweets, संपादित नहीं किए जा सकते।
  • Tweets को 30 मिनट तक और अधिकतम 5 बार संपादित किया जा सकता है। संपादन-योग्य Tweets के लिए आप देख सकते हैं कि संपादन के लिए कितना समय बचा है और कितने और संपादन किए जा सकते हैं।
  • क्या आप किसी Tweet का संपादित संस्करण देख रहे हैं (ज़्यादातर मामलों में API किसी Tweet का सबसे हाल का संस्करण लौटाता है, जब तक कि Tweet ID के ज़रिए किसी खास पुराने संस्करण का अनुरोध न किया गया हो)।
  • Tweet का पूरा संपादन इतिहास।
  • Tweet के हर संस्करण से जुड़ा एंगेजमेंट।

थ्रेडेड बातचीत को ट्रैक करें

एक नया Tweet फ़ील्ड यह पहचानने में मदद करता है कि कोई Tweet किस बातचीत थ्रेड से संबंधित है। conversation ID उस Tweet की Tweet ID होती है जिसने बातचीत शुरू की थी। बातचीत ट्रैकिंग के बारे में अधिक जानें।

माइग्रेट करने के लिए तैयार

v2 endpoints का उपयोग करने के लिए, आपको निम्नलिखित चीज़ों की आवश्यकता होगी: कृपया इस बात का विशेष ध्यान रखें कि कुंजियाँ और टोकन Project के भीतर मौजूद किसी App से ही उपयोग किए जाएँ। यदि आप किसी ऐसे App की कुंजियाँ और टोकन उपयोग कर रहे हैं जो किसी Project के बाहर है, तो आप v2 endpoints पर अनुरोध नहीं कर पाएँगे। एक बार आपके पास डेवलपर खाता हो जाने पर, आप ऊपर दी गई सभी चीज़ें डेवलपर कंसोल में सेट अप कर सकते हैं।

प्रमाणीकरण

नए Twitter API के साथ, अलग-अलग endpoint तक पहुँचने के लिए आप दो अलग-अलग प्रमाणीकरण पैटर्न का उपयोग करेंगे: OAuth 1.0a User Context और OAuth 2.0 बेयरर टोकन। endpoint पर अनुरोध करते समय, दोनों का उद्देश्य अलग-अलग होता है: किसी Twitter उपयोगकर्ता की ओर से अनुरोध करने पर OAuth 1.0a User Context आवश्यक होता है आपके developer ऐप की ओर से अनुरोध करने के लिए OAuth 2.0 बेयरर टोकन आवश्यक होता है

टूल और कोड

शुरुआत करने और नए endpoints तथा क्षमताओं से परिचित होने में आपकी मदद के लिए, आपके काम को तेज़ी से आगे बढ़ाने के कुछ विकल्प हमारे पास हैं:
  • हमारे पास एक Twitter Postman collection है, जिसकी मदद से आप Postman client का उपयोग करके अलग-अलग endpoints पर अनुरोध भेज सकते हैं और उनसे कनेक्ट कर सकते हैं। authentication का परीक्षण करने और endpoints के साथ प्रयोग करने का यह एक आसान तरीका है।
  • हमने Ruby, Python, Node, Java और कई अन्य भाषाओं के लिए Twitter-supported और third-party libraries की एक सूची भी उपलब्ध कराई है। अतिरिक्त संदर्भ के लिए, हमारे tools and libraries page पर नज़र डालें।

अपडेट किए गए एंडपॉइंट्स पर माइग्रेट करना

जब आप नए Twitter v2 एंडपॉइंट्स को एक्सप्लोर करना शुरू करते हैं, तो हमने विस्तृत माइग्रेशन गाइड्स की एक श्रृंखला तैयार की है, ताकि आप पुराने वर्शन की तुलना में प्रत्येक अपडेट किए गए एंडपॉइंट की क्षमताओं को समझ और उनकी तुलना कर सकें:

नए डेटा फ़ॉर्मैट पर माइग्रेट करना

जब आप v1.1 या enterprise से v2 पर माइग्रेट करते हैं, तो यह समझना महत्वपूर्ण है कि डेटा डिलीवर किए जाने के फ़ॉर्मैट में काफ़ी बड़े बदलाव हुए हैं। हमने नए फ़ील्ड्स जोड़े हैं, फ़ील्ड्स के क्रम में बदलाव किया है, और कुछ मामलों में कुछ एलिमेंट्स को पूरी तरह हटा भी दिया है। इन बदलावों के बारे में अधिक जानने के लिए, हम गाइड्स की एक श्रृंखला तैयार कर रहे हैं, जो pre-v2 डेटा फ़ॉर्मैट के फ़ील्ड्स को नए फ़ील्ड्स से मैप करने में आपकी मदद करेगी और यह बताएगी कि इन नए फ़ील्ड्स का अनुरोध कैसे करें। आप इस migration hub के हमारे डेटा फ़ॉर्मैट माइग्रेशन सेक्शन पर जाकर, या हमारे विशिष्ट डेटा फ़ॉर्मैट गाइड्स पर जाकर अधिक जान सकते हैं:

आगे क्या है?

आपमें से जो कुछ समय से प्लेटफ़ॉर्म का उपयोग कर रहे हैं, वे देखेंगे कि कई नए endpoint मौजूदा standard v1.1 और enterprise endpoints के अनुरूप हैं। वास्तव में, हमारा इरादा है कि भविष्य में ये तीनों संस्करणों की जगह ले लें। हमने एक तालिका तैयार की है, ताकि आप समझ सकें कि X API endpoints map पिछले संस्करणों से कैसे संबंधित है। अगर आप देखना चाहते हैं कि आगे क्या आने वाला है, तो कृपया हमारा product roadmap देखें। हमारे पास एक changelog भी है, जिसे देखकर आप समझ सकते हैं कि हम अब तक क्या जारी कर चुके हैं।

हमें आगे क्या बनाना चाहिए?

जैसे-जैसे हम X API v2 की अतिरिक्त क्षमताएँ विकसित कर रहे हैं, हम आपकी राय लगातार सुनना चाहते हैं। हम आपके फ़ीडबैक का स्वागत करते हैं और उसे प्रोत्साहित करते हैं। पहले से सबमिट किए गए विचारों पर नज़र डालें, जो आपकी ज़रूरतों से मेल खाते हों उनके समर्थन में अपनी राय दें, और अपना फ़ीडबैक भी साझा करें!