म्यूट्स लुकअप

म्यूट्स लुकअप: Standard v1.1 की X API v2 से तुलना

यदि आप मानक v1.1 के GET mutes/users/ids और GET mutes/users/list endpoints के साथ काम कर रहे हैं, तो इस गाइड का उद्देश्य मानक v1.1 और X API v2 के म्यूट्स लुकअप endpoints के बीच समानताओं और अंतरों को समझने में आपकी मदद करना है।

• समानताएँ
  • प्रमाणीकरण
• अंतर

  • एंडपॉइंट URL

  • प्रति अनुरोध उपयोगकर्ताओं की सीमा

  • ऐप और प्रोजेक्ट आवश्यकताएँ

  • प्रतिक्रिया डेटा फ़ॉर्मैट

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

समानताएँ

प्रमाणीकरण

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

अंतर

एंडपॉइंट URL

• मानक v1.1 एंडपॉइंट:
  • GET https://api.x.com/1.1/mutes/users/ids.json (उन उपयोगकर्ता IDs की सूची जिन्हें निर्दिष्ट उपयोगकर्ता ने म्यूट किया है)
  • GET https://api.x.com/1.1/mutes/users/lists.json (उन उपयोगकर्ताओं की सूची जिन्हें निर्दिष्ट उपयोगकर्ता ने म्यूट किया है)
• X API v2 एंडपॉइंट:
  • GET https://api.x.com/2/users/:id/muting (उन उपयोगकर्ताओं की सूची जिन्हें निर्दिष्ट उपयोगकर्ता id ने म्यूट किया है)  

प्रति अनुरोध उपयोगकर्ता सीमा

मानक v1.1 एंडपॉइंट आपको प्रति अनुरोध अधिकतम 5000 उपयोगकर्ता लौटाने की अनुमति देते हैं। नए v2 एंडपॉइंट आपको प्रति अनुरोध अधिकतम 1000 उपयोगकर्ता लौटाने की अनुमति देते हैं। पूरे 1000 उपयोगकर्ता लौटाने के लिए, आपको query parameter के रूप में max_results=1000 पास करना होगा; इसके बाद आप अगले अनुरोध में रिस्पॉन्स payload से मिला next_token, pagination_token query parameter में पास कर सकते हैं।  

ऐप और प्रोजेक्ट आवश्यकताएँ

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

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

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

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

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

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

हमने एक data format migration guide भी तैयार की है, जो मानक v1.1 फ़ील्ड्स को नए v2 फ़ील्ड्स से मैप करने में आपकी मदद कर सकती है। यह guide आपको वह specific expansion और field parameter भी बताएगी, जिसे आपको अपने v2 अनुरोध के साथ पास करना होगा ताकि specific फ़ील्ड्स लौटाए जा सकें।   

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

• JSON root level पर, मानक एंडपॉइंट statuses array में Post objects लौटाते हैं, जबकि 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 में नहीं लिखा जाता। Post और user attributes केवल तभी शामिल किए जाते हैं, जब उनकी values non-null हों।   

हमने Post object में फ़ील्ड्स का एक नया सेट भी जोड़ा है, जिनमें निम्नलिखित शामिल हैं:

• एक conversation_id field
• दो नए annotations फ़ील्ड्स, जिनमें context और entities शामिल हैं
• कई नए metrics फ़ील्ड्स 
• एक नया reply_setting field, जो दिखाता है कि किसी दिए गए Post का उत्तर कौन दे सकता है

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

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

मानक	X API v2
stringify_ids	कोई समकक्ष नहीं
cursor	pagination_token
skip_status	कोई समकक्ष नहीं

इसके अलावा, मानक v1.1 म्यूट्स लुकअप अनुरोध पैरामीटर का एक सेट भी है, जो X API v2 में समर्थित नहीं है:

मानक	टिप्पणी
include_entities	इस पैरामीटर का उपयोग पोस्ट payload से entities नोड हटाने के लिए किया जाता है। इसकी जगह additive फ़ील्ड्स और expansions की कार्यक्षमता ने ले ली है।

---

कोड उदाहरण

म्यूट किए गए उपयोगकर्ता प्राप्त करें (v2)

cURL

shellscript

curl "https://api.x.com/2/users/123456789/muting?user.fields=username,verified&max_results=100" \
  -H "Authorization: OAuth ..."