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

प्रमाणीकरण

ब्लॉक्स एंडपॉइंट्स के लिए उपयोगकर्ता प्रमाणीकरण आवश्यक है:
विधिविवरण
PKCE के साथ OAuth 2.0 Authorization Codeनए एप्लिकेशन के लिए अनुशंसित
OAuth 1.0a उपयोगकर्ता संदर्भलीगेसी समर्थन
App-Only प्रमाणीकरण समर्थित नहीं है। आपको किसी उपयोगकर्ता की ओर से प्रमाणीकरण करना होगा।

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

Scopeके लिए आवश्यक
block.readब्लॉक किए गए खातों को प्राप्त करना
block.writeखातों को ब्लॉक और अनब्लॉक करना
users.readblock scopes के साथ आवश्यक

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

मेथडएंडपॉइंटविवरण
GET/2/users/:id/blockingब्लॉक किए गए खातों की सूची प्राप्त करें
POST/2/users/:id/blockingकिसी खाते को ब्लॉक करें
DELETE/2/users/:source_user_id/blocking/:target_user_idकिसी खाते को अनब्लॉक करें

फ़ील्ड्स और expansions

डिफ़ॉल्ट रिस्पॉन्स

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

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

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

जब आप किसी को ब्लॉक करते हैं, तो क्या होता है

वे नहीं कर पाएंगे

  • आपकी पोस्ट्स नहीं देख पाएंगे (जब तक वे लॉग आउट न हों)
  • आपको फ़ॉलो नहीं कर पाएंगे
  • आपको DM नहीं भेज पाएंगे
  • आपको सूचियों में नहीं जोड़ पाएंगे
  • फ़ोटो में आपको टैग नहीं कर पाएंगे

आप नहीं कर पाएंगे

  • उनकी पोस्ट्स नहीं देख पाएंगे
  • उन्हें फ़ॉलो नहीं कर पाएंगे
  • उन्हें DM नहीं भेज पाएंगे
जब आप किसी ऐसे व्यक्ति को ब्लॉक करते हैं जो आपको फ़ॉलो करता है, तो वह अपने-आप आपको फ़ॉलो करना बंद कर देता है।

जिन उपयोगकर्ताओं की ब्लॉक सूची बड़ी होती है, उनके परिणाम पेजों में विभाजित होकर लौटाए जाते हैं:
cURL
# पहला अनुरोध
curl "https://api.x.com/2/users/123/blocking?max_results=100" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

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

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

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

अगले चरण

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

ब्लॉक करने का अपना पहला अनुरोध भेजें

म्यूट

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

API संदर्भ

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

नमूना कोड

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