मुख्य सामग्री पर जाएं
यह मार्गदर्शिका प्रमाणीकृत उपयोगकर्ता के लिए Direct Message इवेंट्स प्राप्त करने की प्रक्रिया समझाती है।
पूर्वापेक्षाएँशुरू करने से पहले, आपको इनकी आवश्यकता होगी:
  • स्वीकृत ऐप के साथ एक डेवलपर खाता
  • उपयोगकर्ता एक्सेस टोकन (OAuth 1.0a या OAuth 2.0 PKCE)

सभी DM इवेंट्स प्राप्त करें

प्रमाणीकृत उपयोगकर्ता के सभी DM इवेंट्स प्राप्त करें:
cURL
curl "https://api.x.com/2/dm_events?\
dm_event.fields=created_at,sender_id,text&\
max_results=100" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

रिस्पॉन्स

{
  "data": [
    {
      "id": "1234567890",
      "event_type": "MessageCreate",
      "text": "Hello! How are you?",
      "sender_id": "9876543210",
      "created_at": "2024-01-15T10:30:00.000Z"
    }
  ],
  "meta": {
    "result_count": 1,
    "next_token": "abc123"
  }
}

एक-से-एक बातचीत प्राप्त करें

किसी खास एक-से-एक बातचीत से DM इवेंट्स प्राप्त करें:
cURL
curl "https://api.x.com/2/dm_conversations/with/9876543210/dm_events?\
dm_event.fields=created_at,sender_id,text" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"
9876543210 को दूसरे प्रतिभागी की उपयोगकर्ता id से बदलें।

ID से बातचीत प्राप्त करें

किसी विशेष बातचीत ID से DM इवेंट्स प्राप्त करें:
cURL
curl "https://api.x.com/2/dm_conversations/1234567890-9876543210/dm_events?\
dm_event.fields=created_at,sender_id,text" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

इवेंट type के आधार पर फ़िल्टर करें

केवल निर्दिष्ट इवेंट type प्राप्त करें:
cURL
curl "https://api.x.com/2/dm_events?\
event_types=MessageCreate&\
dm_event.fields=created_at,sender_id,text" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

ईवेंट प्रकार

प्रकारविवरण
MessageCreateएक संदेश भेजा गया
ParticipantsJoinउपयोगकर्ता बातचीत में शामिल हुआ
ParticipantsLeaveउपयोगकर्ता बातचीत से निकल गया

उपयोगकर्ता डेटा शामिल करें

प्रेषक की जानकारी शामिल करने के लिए विस्तार करें:
cURL
curl "https://api.x.com/2/dm_events?\
dm_event.fields=created_at,sender_id,text&\
expansions=sender_id&\
user.fields=username,profile_image_url" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

एक्सपैंशन के साथ रिस्पॉन्स

{
  "data": [
    {
      "id": "1234567890",
      "event_type": "MessageCreate",
      "text": "Hello!",
      "sender_id": "9876543210"
    }
  ],
  "includes": {
    "users": [
      {
        "id": "9876543210",
        "username": "example_user",
        "profile_image_url": "https://..."
      }
    ]
  }
}

सामान्य पैरामीटर

पैरामीटरविवरण
max_resultsप्रति पृष्ठ इवेंट्स (1-100, डिफ़ॉल्ट 100)
pagination_tokenअगले पृष्ठ के लिए टोकन
dm_event.fieldsलौटाए जाने वाले इवेंट फ़ील्ड्स
event_typesइवेंट type के अनुसार फ़िल्टर करें
expansionsशामिल किए जाने वाले संबंधित ऑब्जेक्ट्स

अगले चरण

DM भेजें

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

इंटीग्रेशन गाइड

मुख्य अवधारणाएँ और सर्वोत्तम प्रक्रियाएँ

API संदर्भ

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