v1 से v2

सूचियों का प्रबंधन: मानक v1.1 की X API v2 से तुलना

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

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

समानताएँ

प्रमाणीकरण

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

अंतर

एंडपॉइंट URL

• मानक v1.1 एंडपॉइंट:
  • POST https://api.x.com/1.1/lists/create.json (एक सूची बनाता है)
  • POST https://api.x.com/1.1/lists/destroy.json (एक सूची हटाता है)
  • POST https://api.x.com/1.1/lists/update.json (एक सूची अपडेट करता है)
• X API v2 एंडपॉइंट:

  • POST https://api.x.com/2/lists (एक सूची बनाता है)

  • DELETE https://api.x.com/2/lists/:id (एक सूची हटाता है)

  • PUT https://api.x.com/2/lists/:id (एक सूची अपडेट करता है)

रेट लिमिट्स

मानक v1.1	X API v2
/1.1/lists/create.json कोई नहीं	/2/lists OAuth 1.0a User Context के साथ 15 मिनट की विंडो में 300 अनुरोध
/1.1/lists/destroy.json कोई नहीं	/2/lists/:id OAuth 1.0a User Context के साथ 15 मिनट की विंडो में 300 अनुरोध
/1.1/lists/update.json कोई नहीं	/2/lists/:id OAuth 1.0a User Context के साथ 15 मिनट की विंडो में 300 अनुरोध

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

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

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

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

एक सूची बनाना

मानक	X API v2
name	name
mode	private
description	description

किसी सूची को हटाना/अपडेट करना

मानक	X API v2
owner_screen_name	कोई समकक्ष नहीं
owner_id	कोई समकक्ष नहीं
list_id	id
slug	कोई समकक्ष नहीं

कृपया ध्यान दें: मानक v1.1 पैरामीटर क्वेरी पैरामीटर के रूप में पास किए जाते हैं, जबकि X API v2 पैरामीटर बॉडी पैरामीटर (POST एंडपॉइंट के लिए) या पाथ पैरामीटर (DELETE और PUT एंडपॉइंट्स के लिए) के रूप में पास किए जाते हैं।

---

कोड उदाहरण

एक सूची बनाएँ (v2)

cURL

shellscript

curl -X POST "https://api.x.com/2/lists" \
  -H "Authorization: OAuth ..." \
  -H "Content-Type: application/json" \
  -d '{"name": "My List", "description": "A great list"}'

किसी सूची को हटाएँ (v2)

cURL

shellscript

curl -X DELETE "https://api.x.com/2/lists/123456789" \
  -H "Authorization: OAuth ..."