Skip to main content

​
v1.1 और v2 Direct Message इवेंट lookup एंडपॉइंट्स की तुलना

Direct Messages एंडपॉइंट्स के v1.1 और v2, दोनों संस्करण Direct Message इवेंट्स को lookup करने के तरीके उपलब्ध कराते हैं। यह गाइड अंतरों को समझने में मदद करने और v2 पर migration के लिए जानकारी देने के उद्देश्य से तैयार की गई है।  दोनों संस्करणों के बीच एक बड़ा अंतर यह है कि v1.1 केवल one-to-one कन्वर्सेशन्स का समर्थन करता है, जबकि v2 में group कन्वर्सेशन्स का समर्थन जोड़ा गया है। इसका एक प्रभाव यह है that v1.1 केवल “message created” इवेंट्स का समर्थन करता है, जबकि v2 उन इवेंट्स का भी समर्थन करता है जो participants के कन्वर्सेशन में शामिल होने और उसे छोड़ने से संबंधित हैं। वास्तव में, v2 का एक मूलभूत अपडेट dm_conversations को एक मुख्य API object के रूप में स्थापित करना है।    v1.1 में Direct Messages प्राप्त करने के लिए दो एंडपॉइंट्स हैं (फिर से, नए messages ही v1.1 में समर्थित एकमात्र इवेंट type हैं):
  • GET direct_messages/events/show - ID के आधार पर एक single इवेंट प्राप्त करता है। 
  • GET direct_messages/events/list - authenticated user द्वारा भेजे और प्राप्त किए गए one-to-one Direct Messages के 30 दिनों तक के messages प्राप्त करता है। ध्यान दें कि यह method group कन्वर्सेशन्स से messages प्राप्त नहीं कर सकता। 
इस v2 release में, Direct Message कन्वर्सेशन इवेंट्स प्राप्त करने के लिए तीन GET methods हैं: 
  • GET /2/dm_conversations/with/:participant_id/dm_events - one-to-one कन्वर्सेशन से जुड़े Direct Message इवेंट्स प्राप्त करता है। :participant_id path parameter उस account की User ID है जो यह request करने वाले authenticated user के साथ कन्वर्सेशन में है। 
  • GET /2/dm_conversations/:dm_conversation_id/dm_events - किसी specific कन्वर्सेशन ID से जुड़े Direct Message इवेंट्स प्राप्त करता है, जैसा कि :dm_conversation_id path parameter से दर्शाया गया है। यह method one-to-one और group कन्वर्सेशन्स, दोनों का समर्थन करता है। 
  • GET /2/dm_events - किसी user से जुड़े Direct Message इवेंट्स प्राप्त करता है, जिनमें one-to-one और group कन्वर्सेशन्स दोनों शामिल हैं। 30 दिन पहले तक के इवेंट्स उपलब्ध हैं।  
एक महत्वपूर्ण विवरण यह है कि कन्वर्सेशन और इवेंट IDs, X Platform के v1.1 और v2 संस्करणों में साझा होते हैं। इसका मतलब है कि दोनों संस्करणों का साथ में उपयोग किया जा सकता है। उदाहरण के लिए, Direct Messages v1.1 एंडपॉइंट्स एक single इवेंट लौटाने और इवेंट्स delete करने के तरीके उपलब्ध कराते हैं, जो methods अभी v2 में उपलब्ध नहीं हैं। चूँकि IDs v1.1 और v2 में समान हैं, आप v2 द्वारा दी गई IDs के आधार पर v1.1 requests कर सकते हैं, या X application में कन्वर्सेशन URLs में दिखने वाली कन्वर्सेशन IDs का संदर्भ ले सकते हैं। नीचे दी गई तालिका v1.1 और v2 Direct Message इवेंट lookup एंडपॉइंट्स के मूलभूत पहलुओं की तुलना करती है। यहाँ साझा की गई X API v2 की विशेषताएँ सभी Direct Message lookup एंडपॉइंट्स पर समान रूप से लागू होती हैं।
विवरणStandard v1.1X API v2
Host domainhttps://api.x.comhttps://api.x.com
एंडपॉइंट root path/1.1/direct_messages/2/dm_conversations

Direct Messages कन्वर्सेशन्स को एक मूलभूत API object के रूप में प्रस्तुत किया गया है। 

ये एंडपॉइंट्स MessageCreate, ParticipantsJoin, और ParticipantLeave इवेंट्स प्राप्त करते हैं।
समर्थित HTTP methodsGETGET
Group Direct Messages का समर्थन करता है✔
समर्थित इवेंट typesmessage_createMessageCreate, ParticipantsJoin, ParticipantsLeave
AuthenticationOAuth 1.0a User ContextOAuth 1.0a User Context

OAuth 2 User Context (scopes: dm.read, tweet.read, user.read)
X API v2 Project से जुड़े developer ऐप के credentials का उपयोग आवश्यक है✔
डिफ़ॉल्ट request रेट लिमिट्स*
*सभी requests के लिए user tokens आवश्यक हैं		GET requests: 15 mins में 300 requests

Rate limit सभी तीन एंडपॉइंट्स पर लागू होती है
नीचे दी गई तालिकाएँ v2 GET methods की तुलना version v1.1 से करती हैं। ध्यान दें कि ये v2 offerings group कन्वर्सेशन्स का समर्थन करके उपलब्ध क्षमताओं का विस्तार करती हैं।  **किसी specific one-to-one कन्वर्सेशन में सभी messages प्राप्त करें **
Path: GET /2/dm_conversations/with/:participant_id/dm_events
विवरणStandard v1.1X API v2
एंडपॉइंट पथGET 

/1.1/direct_messages/events/list		GET /2/dm_conversations/with/:participant_id/dm_events
कितना इवेंट इतिहास उपलब्ध है30 दिनकोई सीमा नहीं
डिफ़ॉल्ट अनुरोध रेट लिमिट्सहर 15 मिनट में 15 अनुरोधहर 15 मिनट में 300 अनुरोध
रेट लिमिट सभी तीनों GET एंडपॉइंट पर लागू होती है
**कन्वर्सेशन ID के आधार पर सभी संदेश प्राप्त करें ** पथ: GET /2/dm_conversations/:dm_conversation_id/dm_events
विवरणStandard v1.1X API v2
एंडपॉइंट पथसमर्थित नहीं है। V1.1 केवल एक-से-एक कन्वर्सेशन के संदेश लौटा सकता है और कन्वर्सेशन ID के आधार पर इवेंट प्राप्त करने का समर्थन नहीं करता।GET /2/dm_conversations/:dm_conversation_id/dm_events
कितना इवेंट इतिहास उपलब्ध है30 दिनकोई सीमा नहीं
ग्रुप कन्वर्सेशन का समर्थन करता है✔
डिफ़ॉल्ट अनुरोध रेट लिमिट्सहर 15 मिनट में 15 अनुरोधहर 15 मिनट में 300 अनुरोध
रेट लिमिट सभी तीनों GET एंडपॉइंट पर लागू होती है
प्रमाणित उपयोगकर्ता के सभी कन्वर्सेशन में मौजूद सभी इवेंट प्राप्त करें, जिनमें एक-से-एक और ग्रुप कन्वर्सेशन दोनों शामिल हैं पथ: GET /2/dm_events
विवरणStandard v1.1X API v2
एंडपॉइंट पथGET /1.1/direct_messages/events/list

V1.1 केवल एक-से-एक कन्वर्सेशन के संदेश लौटा सकता है।		GET /2/dm_events
कितना इवेंट इतिहास उपलब्ध है30 दिन30 दिन
ग्रुप कन्वर्सेशन का समर्थन करता है✔
डिफ़ॉल्ट अनुरोध रेट लिमिट्सहर 15 मिनट में 15 अनुरोधहर 15 मिनट में 300 अनुरोध
रेट लिमिट सभी तीनों GET एंडपॉइंट पर लागू होती है