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

म्यूट एंडपॉइंट्स के एकीकरण के लिए मुख्य अवधारणाएँ और सर्वोत्तम प्रक्रियाएँ

यह मार्गदर्शिका उन मुख्य अवधारणाओं को समझाती है जिनकी आपको अपने एप्लिकेशन में 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

shellscript

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

---

​

पेजिनेशन

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

cURL

shellscript

# पहला अनुरोध
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"

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

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

---

​

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

​

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

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

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

---

​

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

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

---

​

अगले चरण

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

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

ब्लॉक

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

API संदर्भ

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

नमूना कोड

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