v1 से v2

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

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

• समानताएँ
  • OAuth 1.0a उपयोगकर्ता संदर्भ
• अंतर
  • एंडपॉइंट URL
  • ऐप और प्रोजेक्ट की आवश्यकताएँ
  • HTTP मेथड
  • अनुरोध पैरामीटर

समानताएँ

OAuth 1.0a उपयोगकर्ता संदर्भ प्रमाणीकरण विधि

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

अंतर

एंडपॉइंट URL

• मानक v1.1 एंडपॉइंट:
  • POST https://api.x.com/1.1/friendships/create.json (किसी उपयोगकर्ता को फ़ॉलो करें)
  • POST https://api.x.com/1.1/friendships/destroy.json (किसी उपयोगकर्ता को अनफ़ॉलो करें)
• X API v2 एंडपॉइंट:
  • POST https://api.x.com/2/users/:id/following (किसी उपयोगकर्ता को फ़ॉलो करें)
  • DELETE https://api.x.com/2/users/:source_user_id/following/:target_user_id (किसी उपयोगकर्ता को अनफ़ॉलो करें)

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

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

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

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

Standard v1.1	X API v2
कोई समकक्ष नहीं	id (POST), source_user_id (DELETE)
user_id	target_user_id
screen_name	कोई समकक्ष नहीं

कृपया ध्यान दें कि Standard v1.1 पैरामीटर query parameters के रूप में भेजे जाते हैं, जबकि X API v2 पैरामीटर body parameters (POST एंडपॉइंट के लिए) या path parameters (DELETE एंडपॉइंट के लिए) के रूप में भेजे जाते हैं।

इसके अलावा, v2 के id और source_user_id मानक v1.1 एंडपॉइंट्स का उपयोग करते समय आवश्यक नहीं होते, क्योंकि OAuth 1.0a उपयोगकर्ता संदर्भ के साथ भेजे गए Access Tokens से यह अनुमान लगाया जाता था कि फ़ॉलो/अनफ़ॉलो शुरू करने वाला उपयोगकर्ता कौन था।

---

कोड उदाहरण

किसी उपयोगकर्ता को फ़ॉलो करें (v2)

cURL

shellscript

curl -X POST "https://api.x.com/2/users/123456789/following" \
  -H "Authorization: OAuth ..." \
  -H "Content-Type: application/json" \
  -d '{"target_user_id": "2244994945"}'

किसी उपयोगकर्ता को अनफ़ॉलो करें (v2)

cURL

shellscript

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