पूर्वापेक्षाएँशुरू करने से पहले, आपको इनकी आवश्यकता होगी:
- स्वीकृत ऐप के साथ एक डेवलपर खाता
- उपयोगकर्ता एक्सेस टोकन (OAuth 1.0a या OAuth 2.0 PKCE)
सभी 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"
from xdk import Client
client = Client(bearer_token="YOUR_USER_ACCESS_TOKEN")
# पेजिनेशन के साथ सभी DM इवेंट्स प्राप्त करें
for page in client.dm_events.list(
dm_event_fields=["created_at", "sender_id", "text"],
max_results=100
):
for event in page.data:
print(f"{event.event_type}: {event.text}")
import { Client } from "@xdevplatform/xdk";
const client = new Client({ accessToken: "YOUR_USER_ACCESS_TOKEN" });
// पेजिनेशन के साथ सभी DM इवेंट्स प्राप्त करें
const paginator = client.dmEvents.list({
dmEventFields: ["created_at", "sender_id", "text"],
maxResults: 100,
});
for await (const page of paginator) {
page.data?.forEach((event) => {
console.log(`${event.event_type}: ${event.text}`);
});
}
रिस्पॉन्स
{
"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"
}
}
एक-से-एक बातचीत प्राप्त करें
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"
from xdk import Client
client = Client(bearer_token="YOUR_USER_ACCESS_TOKEN")
# एक-से-एक बातचीत से DM इवेंट्स प्राप्त करें
for page in client.dm_events.get_by_participant(
participant_id="9876543210",
dm_event_fields=["created_at", "sender_id", "text"]
):
for event in page.data:
print(f"{event.created_at}: {event.text}")
import { Client } from "@xdevplatform/xdk";
const client = new Client({ accessToken: "YOUR_USER_ACCESS_TOKEN" });
// एक-से-एक बातचीत से DM इवेंट्स प्राप्त करें
const paginator = client.dmEvents.getByParticipant("9876543210", {
dmEventFields: ["created_at", "sender_id", "text"],
});
for await (const page of paginator) {
page.data?.forEach((event) => {
console.log(`${event.created_at}: ${event.text}`);
});
}
9876543210 को दूसरे प्रतिभागी की उपयोगकर्ता id से बदलें।
ID से बातचीत प्राप्त करें
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"
from xdk import Client
client = Client(bearer_token="YOUR_USER_ACCESS_TOKEN")
# ID से किसी बातचीत के DM इवेंट्स प्राप्त करें
for page in client.dm_events.get_by_conversation(
dm_conversation_id="1234567890-9876543210",
dm_event_fields=["created_at", "sender_id", "text"]
):
for event in page.data:
print(f"{event.created_at}: {event.text}")
import { Client } from "@xdevplatform/xdk";
const client = new Client({ accessToken: "YOUR_USER_ACCESS_TOKEN" });
// ID से किसी बातचीत के DM इवेंट्स प्राप्त करें
const paginator = client.dmEvents.getByConversation("1234567890-9876543210", {
dmEventFields: ["created_at", "sender_id", "text"],
});
for await (const page of paginator) {
page.data?.forEach((event) => {
console.log(`${event.created_at}: ${event.text}`);
});
}
इवेंट 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"
from xdk import Client
client = Client(bearer_token="YOUR_USER_ACCESS_TOKEN")
# केवल MessageCreate इवेंट्स प्राप्त करें
for page in client.dm_events.list(
event_types=["MessageCreate"],
dm_event_fields=["created_at", "sender_id", "text"]
):
for event in page.data:
print(f"{event.text}")
import { Client } from "@xdevplatform/xdk";
const client = new Client({ accessToken: "YOUR_USER_ACCESS_TOKEN" });
// केवल MessageCreate इवेंट्स प्राप्त करें
const paginator = client.dmEvents.list({
eventTypes: ["MessageCreate"],
dmEventFields: ["created_at", "sender_id", "text"],
});
for await (const page of paginator) {
page.data?.forEach((event) => {
console.log(event.text);
});
}
ईवेंट प्रकार
| प्रकार | विवरण |
|---|---|
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"
from xdk import Client
client = Client(bearer_token="YOUR_USER_ACCESS_TOKEN")
# प्रेषक की जानकारी के साथ DM इवेंट्स प्राप्त करें
for page in client.dm_events.list(
dm_event_fields=["created_at", "sender_id", "text"],
expansions=["sender_id"],
user_fields=["username", "profile_image_url"]
):
for event in page.data:
# includes से प्रेषक का मिलान करें
print(f"{event.sender_id}: {event.text}")
import { Client } from "@xdevplatform/xdk";
const client = new Client({ accessToken: "YOUR_USER_ACCESS_TOKEN" });
// प्रेषक की जानकारी के साथ DM इवेंट्स प्राप्त करें
const paginator = client.dmEvents.list({
dmEventFields: ["created_at", "sender_id", "text"],
expansions: ["sender_id"],
userFields: ["username", "profile_image_url"],
});
for await (const page of paginator) {
page.data?.forEach((event) => {
console.log(`${event.sender_id}: ${event.text}`);
});
// प्रेषक user ऑब्जेक्ट्स page.includes.users में हैं
}
एक्सपैंशन के साथ रिस्पॉन्स
{
"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 संदर्भ
एंडपॉइंट का पूरा दस्तावेज़ीकरण