मुख्य सामग्री पर जाएं
यह मार्गदर्शिका उन मुख्य अवधारणाओं को समझाती है जिनकी आपको डायरेक्ट मैसेज lookup endpoints को अपने ऐप में एकीकृत करने के लिए आवश्यकता होगी।

​
प्रमाणीकरण

निजी बातचीतों तक पहुँचने के लिए DM एंडपॉइंट्स पर उपयोगकर्ता प्रमाणीकरण आवश्यक है:
MethodDescription
PKCE के साथ OAuth 2.0 Authorization Codeअनुशंसित
OAuth 1.0a User Contextलीगेसी समर्थन
सिर्फ़ ऐप-आधारित प्रमाणीकरण समर्थित नहीं है। सभी डायरेक्ट मैसेज निजी होते हैं।

​
आवश्यक scopes (OAuth 2.0)

Scopeइसके लिए आवश्यक
dm.readइवेंट पढ़ने के लिए
tweet.readdm.read के साथ आवश्यक
users.readdm.read के साथ आवश्यक

​
वार्तालाप के प्रकार

एक-से-एक

इसमें हमेशा ठीक दो प्रतिभागी होते हैं। वार्तालाप ID का प्रारूप: {smaller_user_id}-{larger_user_id}

समूह

इसमें दो या अधिक प्रतिभागी होते हैं। सदस्यता समय के साथ बदल सकती है।

​
इवेंट के प्रकार

इवेंटविवरणमुख्य फ़ील्ड्स
MessageCreateएक संदेश भेजा गयाtext, sender_id
ParticipantsJoinउपयोगकर्ता समूह में शामिल हुआparticipant_ids, sender_id
ParticipantsLeaveउपयोगकर्ता समूह से बाहर निकल गयाparticipant_ids

​
उदाहरण इवेंट

{
  "id": "1582838499983564806",
  "event_type": "MessageCreate",
  "text": "Hi everyone.",
  "sender_id": "944480690",
  "dm_conversation_id": "1578398451921985538",
  "created_at": "2022-10-19T20:58:00.000Z"
}

{
  "id": "1582835469712138240",
  "event_type": "ParticipantsJoin",
  "participant_ids": ["944480690"],
  "sender_id": "17200003",
  "dm_conversation_id": "1578398451921985538",
  "created_at": "2022-10-19T20:45:58.000Z"
}

{
  "id": "1582838535115067392",
  "event_type": "ParticipantsLeave",
  "participant_ids": ["944480690"],
  "dm_conversation_id": "1578398451921985538",
  "created_at": "2022-10-19T20:58:09.000Z"
}

​
फ़ील्ड्स और expansions

​
डिफ़ॉल्ट फ़ील्ड्स

इवेंट प्रकारडिफ़ॉल्ट फ़ील्ड्स
MessageCreateid, event_type, text
ParticipantsJoin/Leaveid, event_type, participant_ids

​
उपलब्ध फ़ील्ड्स

फ़ील्डविवरणइवेंट्स
dm_conversation_idवार्तालाप IDसभी
created_atइवेंट का टाइमस्टैम्पसभी
sender_idकिसने भेजा/आमंत्रित कियाMessageCreate, Join
attachmentsमीडिया संलग्नकMessageCreate
referenced_tweetsसाझा की गई पोस्ट्सMessageCreate

​
उपलब्ध expansions

Expansionलौटाए गए ऑब्जेक्ट
sender_idप्रेषक का User ऑब्जेक्ट
participant_idsप्रतिभागियों के User ऑब्जेक्ट
attachments.media_keysMedia ऑब्जेक्ट
referenced_tweets.idपोस्ट ऑब्जेक्ट

​
expansions के साथ उदाहरण

cURL
curl "https://api.x.com/2/dm_events?\
dm_event.fields=created_at,sender_id,attachments&\
expansions=sender_id,attachments.media_keys&\
user.fields=username,profile_image_url&\
media.fields=url,type" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"
DM इवेंट उल्टे कालानुक्रमिक क्रम में लौटाए जाते हैं (सबसे नए पहले):
cURL
# पहला अनुरोध
curl "https://api.x.com/2/dm_events?max_results=100" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

# पेजिनेशन टोकन के साथ अगला अनुरोध
curl "https://api.x.com/2/dm_events?max_results=100&pagination_token=NEXT_TOKEN" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"
30 दिन पहले तक के इवेंट उपलब्ध हैं।

​
v1.1 के साथ ID की संगतता

वार्तालाप और इवेंट ID, v1.1 और v2 endpoint के बीच साझा किए जाते हैं। इसका मतलब है कि आप यह कर सकते हैं:
  • इवेंट प्राप्त करने के लिए v2 का उपयोग करें, फिर विशिष्ट संदेशों को हटाने के लिए v1.1 का उपयोग करें
  • API अनुरोधों में x.com URL से वार्तालाप ID का संदर्भ दें

​
अगले चरण

त्वरित शुरुआत

अपना पहला DM lookup अनुरोध भेजें

DMs भेजें

डायरेक्ट मैसेज भेजें

API संदर्भ

एंडपॉइंट का पूरा दस्तावेज़

नमूना कोड

काम करने वाले कोड के उदाहरण