Skip to main content

​
रीट्वीट्स लुकअप: Standard v1.1 की X API v2 से तुलना

यदि आप standard v1.1 v1.1 GET statuses/retweets/:id, v1.1 GET statuses/retweets/:ids के साथ काम कर रहे हैं, तो इस गाइड का उद्देश्य standard v1.1 और X API v2 के रीट्वीट्स लुकअप एंडपॉइंट्स के बीच की समानताओं और अंतर को समझने में आपकी मदद करना है।
  • समानताएँ
    • प्रमाणीकरण
    • प्रति रिक्वेस्ट उपयोगकर्ताओं की सीमा
  • भिन्नताएँ
    • एंडपॉइंट URL
    • रिक्वेस्ट की सीमाएँ
    • ऐप और प्रोजेक्ट की आवश्यकताएँ
    • प्रतिक्रिया डेटा का फ़ॉर्मैट
    • रिक्वेस्ट पैरामीटर

​
समानताएँ

प्रमाणीकरण मानक v1.1 और X API v2, दोनों के रीट्वीट्स लुकअप endpoints (v1.1 GET statuses/retweets/:id और v1.1 GET statuses/retweeters/:ids) OAuth 1.0a User Context या OAuth 2.0 बेयरर टोकन का उपयोग करते हैं। प्रति अनुरोध उपयोगकर्ता सीमा v1.1 और v2, दोनों GET endpoints में, रीट्वीट्स लुकअप endpoint अधिकतम 100 उपयोगकर्ता लौटाता है। v2 रीट्वीट्स लुकअप endpoint के लिए कोई pagination token पास नहीं किया जाता; डिफ़ॉल्ट रूप से 100 उपयोगकर्ता दिए जाते हैं, और यही लौटाई जाने वाली अधिकतम संख्या है।

​
अंतर

एंडपॉइंट URL
  • मानक v1.1 एंडपॉइंट:
    • https://api.x.com/1.1/statuses/retweets/:id.json (id पैरामीटर द्वारा निर्दिष्ट पोस्ट के 100 सबसे हाल के Retweets का संग्रह लौटाता है)
    • https://api.x.com/1.1/statuses/retweeters/ids.json (id पैरामीटर द्वारा निर्दिष्ट पोस्ट को Retweet करने वाले उपयोगकर्ताओं की अधिकतम 100 user IDs का संग्रह लौटाता है)
  • X API v2 एंडपॉइंट:
ऐप और प्रोजेक्ट की आवश्यकताएँ X API v2 एंडपॉइंट्स के लिए यह आवश्यक है कि आप अपने अनुरोधों को प्रमाणित करते समय ऐसे developer ऐप के credentials का उपयोग करें, जो किसी Project से संबद्ध हो। सभी X API v1.1 एंडपॉइंट्स, ऐप्स या किसी प्रोजेक्ट से संबद्ध ऐप्स के credentials का उपयोग कर सकते हैं। प्रतिक्रिया डेटा फ़ॉर्मैट मानक v1.1 और X API v2 एंडपॉइंट संस्करणों के बीच सबसे बड़े अंतरों में से एक यह है कि आप यह कैसे चुनते हैं कि आपके payload में कौन-से फ़ील्ड्स लौटें। मानक एंडपॉइंट्स में, आपको डिफ़ॉल्ट रूप से रिस्पॉन्स के कई फ़ील्ड्स मिलते हैं, और फिर parameters का उपयोग करके यह तय करने का विकल्प होता है कि payload में कौन-से फ़ील्ड्स या फ़ील्ड्स के कौन-से सेट लौटने चाहिए। X API v2 संस्करण डिफ़ॉल्ट रूप से केवल user id, name, और username फ़ील्ड्स देता है। किसी भी अतिरिक्त फ़ील्ड्स या objects का अनुरोध करने के लिए, आपको fields और expansions parameters का उपयोग करना होगा। इस एंडपॉइंट से आप जो भी user फ़ील्ड्स अनुरोध करेंगे, वे primary user object में लौटेंगे। कोई भी expanded पोस्ट object और फ़ील्ड्स आपके रिस्पॉन्स के भीतर includes object में लौटेंगे। इसके बाद, आप user object और expanded पोस्ट object, दोनों में मौजूद IDs का मिलान करके expanded objects को user object से जोड़ सकते हैं।  हम आपको प्रोत्साहित करते हैं कि आप इन नए parameters के बारे में उनकी संबंधित guides में अधिक पढ़ें, या fields and expansions का उपयोग कैसे करें पर हमारी guide पढ़ें।  हमने एक data format migration guide भी तैयार की है, जो मानक v1.1 फ़ील्ड्स को नए v2 फ़ील्ड्स से मैप करने में आपकी मदद कर सकती है। यह guide आपको वह specific expansion और field parameter भी बताएगी, जिसे आपको अपने v2 अनुरोध के साथ पास करना होगा, ताकि specific फ़ील्ड्स लौटाए जा सकें।    कुछ फ़ील्ड्स का अनुरोध करने के तरीके में हुए बदलावों के अलावा, X API v2, APIs द्वारा लौटाए गए objects के लिए नए JSON डिज़ाइन भी प्रस्तुत करता है, जिनमें Post और user objects शामिल हैं।
  • JSON root level पर, मानक एंडपॉइंट्स statuses array में पोस्ट objects लौटाते हैं, जबकि X API v2 data array लौटाता है। 
  • Retweeted और Quoted “statuses” का उल्लेख करने के बजाय, X API v2 JSON, Retweeted और Quoted Tweets का उल्लेख करता है। कई legacy और deprecated फ़ील्ड्स, जैसे contributors और user.translator_type, हटाए जा रहे हैं। 
  • favorites (पोस्ट object में) और favourites (user object में), दोनों का उपयोग करने के बजाय, X API v2 like शब्द का उपयोग करता है। 
  • X इस परंपरा को अपना रहा है कि जिन JSON values का कोई मान नहीं होता (उदाहरण के लिए, null), उन्हें payload में नहीं लिखा जाता। पोस्ट और user attributes केवल तभी शामिल किए जाते हैं, जब उनके पास non-null values हों।   
हमने Post object में फ़ील्ड्स का एक नया सेट भी जोड़ा है, जिनमें निम्नलिखित शामिल हैं:
  • एक conversation_id फ़ील्ड
  • दो नए annotations फ़ील्ड्स, जिनमें context और entities शामिल हैं
  • कई नए metrics फ़ील्ड्स 
  • एक नया reply_setting फ़ील्ड, जो दिखाता है कि किसी दिए गए पोस्ट का जवाब कौन दे सकता है
अनुरोध पैरामीटर निम्नलिखित मानक v1.1 अनुरोध पैरामीटर, दो request query parameters (user_id या screen_name) स्वीकार करते थे। X API v2 केवल संख्यात्मक user ID स्वीकार करता है, और इसे endpoint path के हिस्से के रूप में पास किया जाना चाहिए।

​
कोड उदाहरण

​
किसी पोस्ट को Retweet करने वाले उपयोगकर्ताओं को प्राप्त करें (v2)

cURL
curl "https://api.x.com/2/tweets/1234567890/retweeted_by?user.fields=username,verified" \
  -H "Authorization: Bearer $BEARER_TOKEN"