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

​
प्रमाणीकरण

सभी X API v2 एंडपॉइंट के लिए प्रमाणीकरण आवश्यक है। अपने उपयोग के अनुरूप विधि चुनें:
विधिइनके लिए सबसे उपयुक्तक्या निजी मेट्रिक्स तक पहुँच मिल सकती है?
OAuth 2.0 App-Onlyसर्वर-टू-सर्वर, सार्वजनिक डेटानहीं
PKCE के साथ OAuth 2.0 Authorization Codeउपयोगकर्ता-उन्मुख ऐप्सहाँ (अधिकृत उपयोगकर्ता के डेटा के लिए)
OAuth 1.0a User Contextलेगेसी इंटीग्रेशनहाँ (अधिकृत उपयोगकर्ता के डेटा के लिए)

​
App-Only प्रमाणीकरण

सार्वजनिक उपयोगकर्ता डेटा के लिए, बेयरर टोकन का उपयोग करें:
cURL
curl "https://api.x.com/2/users/by/username/XDevelopers" \
  -H "Authorization: Bearer $BEARER_TOKEN"

​
User Context प्रमाणीकरण

प्रमाणीकृत उपयोगकर्ता एंडपॉइंट (/2/users/me) के लिए आवश्यक:
cURL
curl "https://api.x.com/2/users/me" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"
/2/users/me एंडपॉइंट केवल User Context प्रमाणीकरण के साथ काम करता है। App-Only टोकन त्रुटि लौटाएँगे।

​
फ़ील्ड्स और expansions

X API v2 डिफ़ॉल्ट रूप से न्यूनतम डेटा लौटाता है। अपनी आवश्यकतानुसार ठीक वही डेटा प्राप्त करने के लिए fields और expansions का उपयोग करें।

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

{
  "data": {
    "id": "2244994945",
    "name": "X Developers",
    "username": "XDevelopers"
  }
}

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

फ़ील्डविवरण
created_atखाता बनाए जाने का टाइमस्टैम्प
descriptionउपयोगकर्ता का बायो
entitiesबायो में पार्स किए गए URL
locationउपयोगकर्ता द्वारा सेट किया गया स्थान
pinned_tweet_idपिन की गई पोस्ट की ID
profile_image_urlप्रोफ़ाइल इमेज का URL
protectedक्या खाता सुरक्षित है
public_metricsफ़ॉलोअर/फ़ॉलोइंग की संख्या
urlवेबसाइट का URL
verifiedसत्यापन की स्थिति
withheldरोक संबंधी जानकारी
फ़ील्डविवरण
created_atपोस्ट बनाए जाने का टाइमस्टैम्प
textपोस्ट की सामग्री
public_metricsएंगेजमेंट की संख्या
entitiesहैशटैग, मेंशन, URL

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

cURL
curl "https://api.x.com/2/users/by/username/XDevelopers?\
user.fields=created_at,description,public_metrics,verified&\
expansions=pinned_tweet_id&\
tweet.fields=created_at,public_metrics" \
  -H "Authorization: Bearer $BEARER_TOKEN"

​
expansions सहित रिस्पॉन्स

{
  "data": {
    "id": "2244994945",
    "name": "X Developers",
    "username": "XDevelopers",
    "created_at": "2013-12-14T04:35:55.000Z",
    "verified": true,
    "pinned_tweet_id": "1234567890",
    "public_metrics": {
      "followers_count": 583423,
      "following_count": 2048,
      "tweet_count": 14052
    }
  },
  "includes": {
    "tweets": [
      {
        "id": "1234567890",
        "text": "Welcome to the X Developer Platform!",
        "created_at": "2024-01-15T10:00:00.000Z"
      }
    ]
  }
}

फ़ील्ड्स और expansions गाइड

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

​
बैच लुकअप

एक ही अनुरोध में कई उपयोगकर्ताओं की जानकारी प्राप्त करें:
cURL (ID के आधार पर)
curl "https://api.x.com/2/users?ids=2244994945,783214,6253282&\
user.fields=username,verified" \
  -H "Authorization: Bearer $BEARER_TOKEN"
बैच अनुरोधों में अधिकतम 100 उपयोगकर्ता शामिल हो सकते हैं। बड़े डेटासेट के लिए कई अनुरोधों का उपयोग करें।

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

​
सामान्य त्रुटियाँ

स्थितित्रुटिसमाधान
400अमान्य अनुरोधपैरामीटर के फ़ॉर्मैट की जाँच करें
401अनधिकृतप्रमाणीकरण क्रेडेंशियल्स सत्यापित करें
403निषिद्धऐप अनुमतियों की जाँच करें
404नहीं मिलाउपयोगकर्ता मौजूद नहीं है या उसे निलंबित कर दिया गया है
429बहुत अधिक अनुरोधप्रतीक्षा करें और फिर से प्रयास करें (रेट लिमिट्स देखें)

​
निलंबित या हटाए गए उपयोगकर्ता

यदि कोई उपयोगकर्ता निलंबित है या हटा दिया गया है:
  • Single user लुकअप 404 लौटाता है
  • Multi-user लुकअप परिणामों में उस उपयोगकर्ता को शामिल नहीं करता और errors array लौटाता है
{
  "data": [
    { "id": "2244994945", "username": "XDevelopers" }
  ],
  "errors": [
    {
      "resource_id": "1234567890",
      "resource_type": "user",
      "title": "Not Found Error",
      "detail": "Could not find user with id: [1234567890]."
    }
  ]
}

​
संरक्षित उपयोगकर्ता

उन संरक्षित खातों के लिए जिन्हें आप फ़ॉलो नहीं करते हैं:
  • मूल जानकारी (id, नाम, उपयोगकर्ता नाम) उपलब्ध होती है
  • संरक्षित सामग्री (पिन की गई पोस्ट) तक पहुंच सीमित हो सकती है
  • protected: true खाते की स्थिति को दर्शाता है

​
सर्वोत्तम अभ्यास

बैच अनुरोध

एक बार में अधिकतम 100 उपयोगकर्ताओं को फ़ेच करने के लिए multi-user एंडपॉइंट्स का उपयोग करें, जिससे API कॉल कम होती हैं।

केवल आवश्यक फ़ील्ड्स का अनुरोध करें

रिस्पॉन्स का आकार कम रखने के लिए केवल वही फ़ील्ड्स निर्दिष्ट करें जिनकी आपको आवश्यकता है।

उपयोगकर्ता डेटा कैश करें

बार-बार किए जाने वाले अनुरोधों को कम करने के लिए उपयोगकर्ता प्रोफ़ाइलों को लोकल रूप से कैश करें।

त्रुटियों को सहजता से संभालें

बैच रिस्पॉन्स में आंशिक त्रुटियों की जाँच करें।

​
अगले चरण

API संदर्भ

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

डेटा शब्दकोश

सभी उपलब्ध ऑब्जेक्ट और फ़ील्ड्स

नमूना कोड

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

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

त्रुटियों को आसानी से संभालें