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

सूची लुकअप को एकीकृत करने के लिए प्रमुख अवधारणाएँ और सर्वोत्तम प्रथाएँ

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

---

​

प्रमाणीकरण

सूची लुकअप एंडपॉइंट कई प्रमाणीकरण विधियों का समर्थन करते हैं:

विधि	किसके लिए सबसे उपयुक्त	निजी सूचियों तक पहुँच?
OAuth 2.0 App-Only	सार्वजनिक सूची डेटा	नहीं
OAuth 2.0 Authorization Code with PKCE	उपयोगकर्ता-उन्मुख ऐप	हाँ (आपकी/फ़ॉलो की गई)
OAuth 1.0a User Context	लेगेसी इंटीग्रेशन	हाँ (आपकी/फ़ॉलो की गई)

​

उदाहरण अनुरोध

cURL

shellscript

curl "https://api.x.com/2/lists/84839422?\
list.fields=description,member_count,follower_count,private" \
  -H "Authorization: Bearer $BEARER_TOKEN"

---

​

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

Method	Endpoint	Description
GET	/2/lists/:id	id द्वारा सूची प्राप्त करें
GET	/2/users/:id/owned_lists	उपयोगकर्ता के स्वामित्व वाली सूचियाँ प्राप्त करें

---

​

फ़ील्ड्स और expansions

​

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

{
  "data": {
    "id": "84839422",
    "name": "Tech News"
  }
}

​

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

list.fields

फ़ील्ड	विवरण
created_at	सूची बनाए जाने का टाइमस्टैम्प
description	सूची का विवरण
follower_count	फ़ॉलोअर्स की संख्या
member_count	सदस्यों की संख्या
owner_id	स्वामी की उपयोगकर्ता ID
private	क्या सूची निजी है

user.fields (requires owner_id विस्तार)

फ़ील्ड	विवरण
username	स्वामी का @handle
name	swामी का प्रदर्शित नाम
verified	स्वामी की सत्यापन स्थिति
profile_image_url	स्वामी के अवतार का URL

​

विस्तारs के साथ उदाहरण

cURL

shellscript

curl "https://api.x.com/2/lists/84839422?\
list.fields=description,member_count,follower_count,owner_id&\
expansions=owner_id&\
user.fields=username,verified" \
  -H "Authorization: Bearer $BEARER_TOKEN"

​

विस्तार के साथ रिस्पॉन्स

{
  "data": {
    "id": "84839422",
    "name": "Tech News",
    "description": "Top tech journalists",
    "member_count": 50,
    "follower_count": 1250,
    "owner_id": "2244994945"
  },
  "includes": {
    "users": [
      {
        "id": "2244994945",
        "username": "XDevelopers",
        "verified": true
      }
    ]
  }
}

फ़ील्ड्स और expansions मार्गदर्शिका

रिस्पॉन्स को कस्टमाइज़ करने के बारे में और जानें

---

​

पेजिनेशन

स्वामित्व वाली सूचियाँ प्राप्त करते समय, परिणाम पेजिनेट किए जाते हैं:

cURL

shellscript

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

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

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

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

---

​

निजी सूचियाँ

• निजी सूचियाँ केवल स्वामी को दिखाई देती हैं
• निजी सूची का विवरण प्राप्त करने के लिए आपको स्वामी के रूप में प्रमाणित होना होगा
• private फ़ील्ड यह बताती है कि कोई सूची निजी है या नहीं

---

​

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

स्थिति	त्रुटि	समाधान
400	अमान्य अनुरोध	सूची ID का प्रारूप जाँचें
401	अनधिकृत	प्रमाणीकरण सत्यापित करें
403	निषिद्ध	सूची निजी हो सकती है
404	नहीं मिला	सूची मौजूद नहीं है
429	बहुत अधिक अनुरोध	प्रतीक्षा करें और फिर से प्रयास करें

---

​

अगले चरण

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

अपना पहला सूची लुकअप अनुरोध भेजें

सूची पोस्ट्स

किसी सूची से पोस्ट्स प्राप्त करें

API संदर्भ

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

नमूना कोड

कार्यशील कोड उदाहरण