लाइक्स लुकअप

लाइक्स लुकअप: Standard v1.1 बनाम X API v2

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

v2 में, हमने एक नया liked users एंडपॉइंट भी पेश किया है, जो आपको किसी पोस्ट को लाइक करने वाले उपयोगकर्ताओं की जानकारी प्राप्त करने देता है।

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

  • एंडपॉइंट URL

  • अनुरोध संबंधी सीमाएँ

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

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

  • नया JSON प्रारूप

समानताएँ

प्रमाणीकरण

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

आपकी पसंद की authentication library/package के आधार पर, बेयरर टोकन प्रमाणीकरण शुरुआत करने का सबसे आसान तरीका हो सकता है, और इसे एक साधारण request header के साथ सेट किया जा सकता है। बेयरर टोकन कैसे जनरेट करें, यह जानने के लिए यह OAuth 2.0 Bearer Token guide देखें।   

रेट लिमिट्स

स्टैंडर्ड v1.1 GET favorites/list endpoint में प्रति उपयोगकर्ता प्रति 15 मिनट 75 requests की रेट लिमिट है। v2 में इसके अनुरूप liked पोस्ट्स endpoint में भी यही रेट लिमिट है। हालांकि, इस v2 endpoint में प्रति ऐप प्रति 15 मिनट 75 requests की एक अतिरिक्त रेट लिमिट भी है।

अंतर

एंडपॉइंट URLs

• मानक v1.1 एंडपॉइंट्स:
  • GET https://api.x.com/1.1/favorites/list.json (निर्दिष्ट उपयोगकर्ता की पोस्ट्स की सूची)
  • v2 liking users एंडपॉइंट का v1.1 में कोई समकक्ष नहीं है
• X API v2 एंडपॉइंट:
  • GET https://api.x.com/2/users/:id/liked_tweets (निर्दिष्ट उपयोगकर्ता id द्वारा लाइक की गई पोस्ट्स की सूची)
  • GET https://api.x.com/2/tweets/:id/liking_users (निर्दिष्ट पोस्ट id को लाइक करने वाले उपयोगकर्ताओं की सूची)

अनुरोध सीमाएँ

v2 liked Posts एंडपॉइंट आपको प्रति अनुरोध 5 से 100 पोस्ट्स तक माँगने की अनुमति देता है, लेकिन pagination tokens का उपयोग करके आप किसी पोस्ट के सभी लाइक्स प्राप्त कर सकते हैं। v1.1 GET favorites/list एंडपॉइंट भी आपको पोस्ट्स के सभी लाइक्स प्राप्त करने देता है, लेकिन इसमें आप प्रति अनुरोध 20 से 200 पोस्ट्स तक प्राप्त कर सकते हैं।

v2 liking users एंडपॉइंट में, आप प्रति पोस्ट 100 liking users तक सीमित हैं।   

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

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

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

निम्नलिखित मानक v1.1 अनुरोध पैरामीटर दो request query parameters स्वीकार करते थे (user_id या screen_name)। X API v2 केवल संख्यात्मक user ID स्वीकार करता है, और इसे एंडपॉइंट path के हिस्से के रूप में पास किया जाना चाहिए।

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

नया JSON फ़ॉर्मैट

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

• JSON root स्तर पर, मानक एंडपॉइंट्स statuses array में user ऑब्जेक्ट्स लौटाते हैं, जबकि X API v2 data array लौटाता है। 
• Retweeted और Quoted “statuses” का संदर्भ देने के बजाय, X API v2 JSON Retweeted और Quoted Tweets का संदर्भ देता है। contributors और user.translator_type जैसे कई legacy और deprecated फ़ील्ड्स हटाए जा रहे हैं। 
• Post ऑब्जेक्ट में favorites और user ऑब्जेक्ट में favourites, दोनों का उपयोग करने के बजाय, X API v2 like शब्द का उपयोग करता है। 
• X इस परंपरा को अपना रहा है कि जिन JSON values का कोई मान नहीं होता (उदाहरण के लिए, null), उन्हें payload में नहीं लिखा जाता। पोस्ट और user attributes केवल तभी शामिल किए जाते हैं, जब उनके मान non-null हों।  

हमारे नए JSON फ़ॉर्मैट में किए गए बदलावों के अलावा, हमने Post ऑब्जेक्ट में फ़ील्ड्स का एक नया सेट भी पेश किया है, जिनमें निम्नलिखित शामिल हैं:

• conversation_id
• दो नए पोस्ट annotations फ़ील्ड्स, जिनमें context और entities शामिल हैं
• कई नए metrics फ़ील्ड्स

---

कोड उदाहरण

पसंद किए गए पोस्ट्स पाएं (v2)

cURL

shellscript

curl "https://api.x.com/2/users/2244994945/liked_tweets?tweet.fields=created_at,public_metrics&max_results=100" \
  -H "Authorization: Bearer $BEARER_TOKEN"

पसंद करने वाले उपयोगकर्ताओं को प्राप्त करें (v2)

cURL

shellscript

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