सूची सदस्यों का लुकअप

सूची सदस्यों का लुकअप: स्टैंडर्ड v1.1 की X API v2 से तुलना

यदि आप स्टैंडर्ड v1.1 GET lists/members और GET lists/memberships एंडपॉइंट्स के साथ काम कर रहे हैं, तो इस गाइड का उद्देश्य आपको स्टैंडर्ड v1.1 और X API v2 सूची सदस्य एंडपॉइंट्स के बीच की समानताओं और अंतरों को समझने में मदद करना है।

• समानताएँ
  • प्रमाणीकरण विधियाँ
• अंतर
  • एंडपॉइंट URL
  • रेट लिमिट्स
  • ऐप और प्रोजेक्ट आवश्यकताएँ
  • प्रति अनुरोध डेटा ऑब्जेक्ट की सीमाएँ
  • प्रतिक्रिया डेटा प्रारूप
  • अनुरोध पैरामीटर

समानताएँ

प्रमाणीकरण

एंडपॉइंट के दोनों संस्करण OAuth 1.0a User Context और केवल ऐप, दोनों का समर्थन करते हैं। इसलिए, यदि आप पहले मानक v1.1 सूची सदस्य एंडपॉइंट में से किसी एक का उपयोग कर रहे थे, तो X API v2 संस्करण पर माइग्रेट करने के बाद भी आप उसी प्रमाणीकरण विधि का उपयोग जारी रख सकते हैं।

आपकी चुनी हुई प्रमाणीकरण लाइब्रेरी/पैकेज के आधार पर, केवल ऐप प्रमाणीकरण शायद शुरुआत करने का सबसे आसान तरीका है, और इसे एक साधारण अनुरोध हेडर के साथ सेट किया जा सकता है। केवल ऐप Access Token जनरेट करने का तरीका जानने के लिए, यह केवल ऐप गाइड देखें।

अंतर

एंडपॉइंट URL

• Standard v1.1 एंडपॉइंट्स:
  • GET https://api.x.com/1.1/lists/members.json (निर्दिष्ट सूची के सदस्यों को देखें)
  • GET https://api.x.com/1.1/lists/memberships.json (उन सूचियों को देखें जिनका कोई उपयोगकर्ता सदस्य है)
• X API v2 एंडपॉइंट:

  • GET https://api.x.com/2/lists/:id/members (निर्दिष्ट सूची के सदस्यों को देखें)

  • GET https://api.x.com/2/users/:id/list_memberships (उन सूचियों को देखें जिनका कोई उपयोगकर्ता सदस्य है)

रेट लिमिट्स

Standard v1.1	X API v2
/1.1/lists/members.json OAuth 1.0a User Context के साथ प्रति 15-मिनट विंडो में 900 अनुरोध केवल ऐप के साथ प्रति 15-मिनट विंडो में 15 अनुरोध	/2/lists/:id/members OAuth 1.0a User Context के साथ प्रति 15-मिनट विंडो में 900 अनुरोध OAuth 2.0 Authorization Code with PKCE के साथ प्रति 15-मिनट विंडो में 900 अनुरोध केवल ऐप के साथ प्रति 15-मिनट विंडो में 900 अनुरोध
/1.1/lists/memberships.json OAuth 1.0a User Context के साथ प्रति 15-मिनट विंडो में 15 अनुरोध केवल ऐप के साथ प्रति 15-मिनट विंडो में 15 अनुरोध	/2/users/:id/list_memberships OAuth 1.0a User Context के साथ प्रति 15-मिनट विंडो में 15 अनुरोध OAuth 2.0 Authorization Code with PKCE के साथ प्रति 15-मिनट विंडो में 15 अनुरोध केवल ऐप के साथ प्रति 15-मिनट विंडो में 15 अनुरोध

ऐप और Project आवश्यकताएँ

X API v2 एंडपॉइंट्स के लिए आवश्यक है कि आप अपने अनुरोधों को प्रमाणित करते समय ऐसे developer ऐप के credentials का उपयोग करें, जो किसी Project से संबद्ध हो। सभी X API v1.1 एंडपॉइंट्स, ऐप्स या किसी project से संबद्ध ऐप्स के credentials का उपयोग कर सकते हैं।

प्रति अनुरोध डेटा ऑब्जेक्ट सीमाएँ

मानक v1.1 /1.1/lists/members एंडपॉइंट आपको प्रति अनुरोध अधिकतम 5000 users लौटाने की अनुमति देता है। नए v2 एंडपॉइंट्स आपको प्रति अनुरोध अधिकतम 100 users लौटाने की अनुमति देते हैं। डिफ़ॉल्ट रूप से 100 user objects लौटाए जाते हैं। परिणामों की संख्या बदलने के लिए आपको query parameter max_results= में 1-100 के बीच कोई संख्या देनी होगी; इसके बाद आप रिस्पॉन्स payload में लौटाए गए next_token को अपने अगले अनुरोध में pagination_token query parameter के रूप में भेज सकते हैं।

 इसके अलावा, /1.1/lists/memberships एंडपॉइंट आपको प्रति अनुरोध अधिकतम 1000 सूचियाँ लौटाने की अनुमति देता है। इसके v2 प्रतिस्थापन में, यह एंडपॉइंट प्रति अनुरोध अधिकतम 100 सूचियाँ लौटाने की अनुमति देता है। डिफ़ॉल्ट रूप से 100 List objects लौटाए जाते हैं; परिणामों की संख्या बदलने के लिए max_results= और pagination_token query parameters का उपयोग /1.1/lists/members की तरह ही करें।

प्रतिक्रिया डेटा प्रारूप

मानक v1.1 और X API v2 एंडपॉइंट संस्करणों के बीच सबसे बड़े अंतरों में से एक यह है कि आप यह कैसे चुनते हैं कि आपके payload में कौन-से फ़ील्ड्स लौटें।

मानक एंडपॉइंट्स में, आपको डिफ़ॉल्ट रूप से कई रिस्पॉन्स फ़ील्ड्स मिलते हैं, और फिर आप parameters का उपयोग करके यह तय कर सकते हैं कि payload में कौन-से अतिरिक्त फ़ील्ड्स या फ़ील्ड्स के समूह लौटाए जाएँ।

X API v2 संस्करण /users/:id/list_memberships डिफ़ॉल्ट रूप से List id और name फ़ील्ड्स देगा। किसी भी अतिरिक्त फ़ील्ड्स या objects का अनुरोध करने के लिए, आपको fields और expansions parameters का उपयोग करना होगा। इस एंडपॉइंट से जिन भी List फ़ील्ड्स का आप अनुरोध करेंगे, वे primary List object में लौटेंगी। कोई भी expanded object और फ़ील्ड्स आपके रिस्पॉन्स के भीतर includes object में लौटेंगे। इसके बाद आप primary और expanded object, दोनों में मौजूद IDs का मिलान करके expanded objects को primary List object से जोड़ सकते हैं। 

यहाँ संभावित List फ़ील्ड्स और expansions के कुछ उदाहरण दिए गए हैं:

• created_at

• follower_count

• member_count

• owner_id

• description

• private

एंडपॉइंट	Expansion
/2/lists/:id/members	pinned_tweet_id
/2/users/:id/list_memberships	owner_id

हम आपको प्रोत्साहित करते हैं कि इन नए parameters के बारे में उनके संबंधित guides में और पढ़ें, या fields और expansions का उपयोग कैसे करें पर हमारी guide पढ़ें। 

हमने एक डेटा फ़ॉर्मैट माइग्रेशन गाइड भी तैयार की है, जो आपको standard v1.1 फ़ील्ड्स को नए v2 फ़ील्ड्स से मैप करने में मदद कर सकती है। यह गाइड आपको उस विशिष्ट expansion और field पैरामीटर के बारे में भी बताएगी, जिन्हें आपको अपनी v2 रिक्वेस्ट के साथ पास करना होगा, ताकि खास फ़ील्ड्स लौटाए जा सकें। 

कुछ फ़ील्ड्स का अनुरोध करने के तरीके में बदलावों के अलावा, X API v2 API द्वारा लौटाए जाने वाले ऑब्जेक्ट्स के लिए नए JSON डिज़ाइन भी पेश कर रहा है, जिनमें पोस्ट और उपयोगकर्ता ऑब्जेक्ट शामिल हैं।

• JSON root level पर, standard endpoints statuses array में पोस्ट ऑब्जेक्ट लौटाते हैं, जबकि X API v2 data array लौटाता है। 

• Retweeted और Quoted “statuses” का संदर्भ देने के बजाय, X API v2 JSON Retweeted और Quoted Tweets का संदर्भ देता है। contributors और user.translator_type जैसे कई legacy और deprecated फ़ील्ड्स हटाए जा रहे हैं। 

• Post object में favorites और user object में favourites, दोनों का उपयोग करने के बजाय, X API v2 like शब्द का उपयोग करता है। 

• X इस convention को अपना रहा है कि जिन JSON values का कोई मान नहीं होता (उदाहरण के लिए, null), उन्हें payload में नहीं लिखा जाता। पोस्ट और उपयोगकर्ता attributes केवल तभी शामिल किए जाते हैं, जब उनके मान non-null हों।

अनुरोध पैरामीटर

निम्नलिखित standard v1.1 अनुरोध पैरामीटर के X API v2 में समकक्ष हैं:

सूची सदस्यों का lookup

Standard v1.1	X API v2
list_id	id
slug	कोई समकक्ष नहीं
owner_screen_name	कोई समकक्ष नहीं
owner_id	कोई समकक्ष नहीं
count	max_results
cursor	pagination_token
include_entities	कोई समकक्ष नहीं
skip_status	कोई समकक्ष नहीं

सूची सदस्यता lookup

Standard v1.1	X API v2
user_id	id
screen_name	कोई समकक्ष नहीं
count	max_results
cursor	pagination_token