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 एंडपॉइंट्स पर समान रूप से लागू होती हैं। नीचे दी गई तालिकाएँ v2 GET methods की तुलना version v1.1 से करती हैं। ध्यान दें कि ये v2 offerings group कन्वर्सेशन्स का समर्थन करके उपलब्ध क्षमताओं का विस्तार करती हैं।  **किसी specific one-to-one कन्वर्सेशन में सभी messages प्राप्त करें **
Path: GET /2/dm_conversations/with/:participant_id/dm_events **कन्वर्सेशन ID के आधार पर सभी संदेश प्राप्त करें ** पथ: GET /2/dm_conversations/:dm_conversation_id/dm_events प्रमाणित उपयोगकर्ता के सभी कन्वर्सेशन में मौजूद सभी इवेंट प्राप्त करें, जिनमें एक-से-एक और ग्रुप कन्वर्सेशन दोनों शामिल हैं पथ: GET /2/dm_events