एकीकरण मार्गदर्शिका

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

प्रमाणीकरण

निजी म्यूट सूचियों तक पहुँचने के लिए म्यूट एंडपॉइंट्स पर उपयोगकर्ता प्रमाणीकरण आवश्यक है:

विधि	विवरण
PKCE के साथ OAuth 2.0 Authorization Code	नए ऐप्स के लिए अनुशंसित
OAuth 1.0a User Context	लेगेसी सपोर्ट

केवल ऐप प्रमाणीकरण समर्थित नहीं है। आपको किसी उपयोगकर्ता की ओर से प्रमाणीकरण करना होगा।

आवश्यक स्कोप (OAuth 2.0)

Scope	इनके लिए आवश्यक
`mute.read`	म्यूट किए गए खातों को प्राप्त करने के लिए
`mute.write`	खातों को म्यूट और अनम्यूट करने के लिए
`users.read`	म्यूट स्कोप के साथ आवश्यक

एंडपॉइंट्स का अवलोकन

Method	Endpoint	Description
GET	`/2/users/:id/muting`	म्यूट किए गए खातों की सूची प्राप्त करें
POST	`/2/users/:id/muting`	किसी खाते को म्यूट करें
DELETE	`/2/users/:source_user_id/muting/:target_user_id`	किसी खाते को अनम्यूट करें

फ़ील्ड्स और expansions

डिफ़ॉल्ट प्रतिक्रिया

{
  "data": [
    {
      "id": "1234567890",
      "name": "Example User",
      "username": "example"
    }
  ]
}

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

user.fields

फ़ील्ड	विवरण
`created_at`	खाता बनाए जाने की तिथि
`description`	उपयोगकर्ता का परिचय
`profile_image_url`	प्रोफ़ाइल चित्र का URL
`public_metrics`	फ़ॉलोअर/फ़ॉलोइंग की संख्या
`verified`	सत्यापन की स्थिति

expansions

expansions	विवरण
`pinned_tweet_id`	उपयोगकर्ता की पिन की गई पोस्ट

फ़ील्ड्स के साथ उदाहरण

cURL

curl "https://api.x.com/2/users/123456789/muting?\
user.fields=username,verified,created_at&\
max_results=100" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

from xdk import Client

client = Client(bearer_token="YOUR_USER_ACCESS_TOKEN")

# अतिरिक्त फ़ील्ड्स के साथ म्यूट किए गए यूज़र प्राप्त करें
for page in client.users.get_muting(
    user_id="123456789",
    user_fields=["username", "verified", "created_at"],
    max_results=100
):
    for user in page.data:
        print(f"{user.username} - Verified: {user.verified}")

import { Client } from "@xdevplatform/xdk";

const client = new Client({ accessToken: "YOUR_USER_ACCESS_TOKEN" });

const paginator = client.users.getMuting("123456789", {
  userFields: ["username", "verified", "created_at"],
  maxResults: 100,
});

for await (const page of paginator) {
  page.data?.forEach((user) => {
    console.log(`${user.username} - Verified: ${user.verified}`);
  });
}

पेजिनेशन

जिन उपयोगकर्ताओं की म्यूट सूची बड़ी होती है, उनके लिए परिणाम पेजों में विभाजित किए जाते हैं:

cURL

# पहला अनुरोध
curl "https://api.x.com/2/users/123/muting?max_results=100" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

# पेजिनेशन टोकन के साथ अगला अनुरोध
curl "https://api.x.com/2/users/123/muting?max_results=100&pagination_token=NEXT_TOKEN" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

from xdk import Client

client = Client(bearer_token="YOUR_USER_ACCESS_TOKEN")

# SDK पेजिनेशन को अपने-आप संभालता है
all_muted = []

for page in client.users.get_muting(user_id="123", max_results=100):
    if page.data:
        all_muted.extend(page.data)

print(f"{len(all_muted)} उपयोगकर्ताओं को म्यूट किया गया")

import { Client } from "@xdevplatform/xdk";

const client = new Client({ accessToken: "YOUR_USER_ACCESS_TOKEN" });

async function getAllMutedUsers(userId) {
  const allMuted = [];

  // SDK पेजिनेशन को अपने-आप संभालता है
  const paginator = client.users.getMuting(userId, { maxResults: 100 });

  for await (const page of paginator) {
    if (page.data) {
      allMuted.push(...page.data);
    }
  }

  return allMuted;
}

// उपयोग
const muted = await getAllMutedUsers("123");
console.log(`${muted.length} उपयोगकर्ताओं को म्यूट किया गया`);

पेजिनेशन गाइड

पेजिनेशन के बारे में और जानें

व्यवहार संबंधी अंतर

म्यूट करना बनाम ब्लॉक करना

सुविधा	म्यूट	ब्लॉक
उनकी पोस्ट्स दिखें	नहीं (छिपी हुई)	नहीं
उन्हें आपकी पोस्ट्स दिखें	हाँ	नहीं
वे आपको फ़ॉलो करें	हाँ (फ़ॉलो कर सकते हैं)	नहीं (हटा दिया जाता है)
वे आपको DM भेज सकें	हाँ	नहीं
सूचना भेजी जाती है	नहीं	नहीं

म्यूट करना निजी होता है — म्यूट किए गए उपयोगकर्ता को इसकी सूचना नहीं मिलती और उसे पता नहीं चलता कि उसे म्यूट किया गया है।

त्रुटि प्रबंधन

Status	Error	Solution
400	अमान्य अनुरोध	उपयोगकर्ता id का प्रारूप जाँचें
401	अनधिकृत	एक्सेस टोकन सत्यापित करें
403	निषिद्ध	स्कोप और अनुमतियों की जाँच करें
404	नहीं मिला	उपयोगकर्ता मौजूद नहीं है
429	बहुत अधिक अनुरोध	प्रतीक्षा करें और फिर से प्रयास करें

अगले चरण

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

अपना पहला म्यूट अनुरोध करें

ब्लॉक

म्यूट करने के बजाय उपयोगकर्ताओं को ब्लॉक करें

API संदर्भ

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

नमूना कोड

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

अवलोकन

पोस्ट्स

उपयोगकर्ता

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

लाइक्स

सूचियाँ

Spaces

Communities

Community Notes

ट्रेंड्स

समाचार

मीडिया

X गतिविधि

उपयोग

स्ट्रीम कनेक्शन

अनुपालन

Enterprise v2

लाइक्स स्ट्रीम्स

GNIP 2.0

एकीकरण मार्गदर्शिका

प्रमाणीकरण

आवश्यक स्कोप (OAuth 2.0)

एंडपॉइंट्स का अवलोकन

फ़ील्ड्स और expansions

डिफ़ॉल्ट प्रतिक्रिया

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

फ़ील्ड्स के साथ उदाहरण

पेजिनेशन गाइड

व्यवहार संबंधी अंतर

म्यूट करना बनाम ब्लॉक करना

त्रुटि प्रबंधन

अगले चरण

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

ब्लॉक

API संदर्भ

नमूना कोड