एकीकरण गाइड

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

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

---

प्रमाणीकरण

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

विधि	विवरण
PKCE के साथ OAuth 2.0 Authorization Code	नए एप्लिकेशन के लिए अनुशंसित
OAuth 1.0a उपयोगकर्ता संदर्भ	लीगेसी समर्थन

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

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

Scope	के लिए आवश्यक
block.read	ब्लॉक किए गए खातों को प्राप्त करना
block.write	खातों को ब्लॉक और अनब्लॉक करना
users.read	block 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"
    }
  ]
}

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

user.fields

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

expansions

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

---

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

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

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

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

• उनकी पोस्ट्स नहीं देख पाएंगे
• उन्हें फ़ॉलो नहीं कर पाएंगे
• उन्हें DM नहीं भेज पाएंगे

जब आप किसी ऐसे व्यक्ति को ब्लॉक करते हैं जो आपको फ़ॉलो करता है, तो वह अपने-आप आपको फ़ॉलो करना बंद कर देता है।

---

पैजिनेशन

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

cURL

shellscript

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

---

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

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

---

अगले चरण

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

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

म्यूट

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

API संदर्भ

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

नमूना कोड

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