अपना पहला अनुरोध करें

कुछ ही मिनटों में X API का इस्तेमाल शुरू करें

यह गाइड आपको अपना पहला X API अनुरोध करने का तरीका बताती है। शुरू करने से पहले आपके पास ऐप क्रेडेंशियल्स वाला एक डेवलपर खाता होना चाहिए।

---

cURL के साथ त्वरित शुरुआत

API का परीक्षण करने का सबसे तेज़ तरीका cURL का उपयोग करना है। आइए किसी उपयोगकर्ता को खोजकर देखते हैं:

curl "https://api.x.com/2/users/by/username/xdevelopers" \
  -H "Authorization: Bearer $BEARER_TOKEN"

$BEARER_TOKEN को अपने वास्तविक बेयरर टोकन से बदलें। आपको कुछ इस तरह का रिस्पॉन्स मिलेगा:

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

---

चरण-दर-चरण मार्गदर्शिका

1. अपना बेयरर टोकन प्राप्त करें

   डेवलपर कंसोल में जाएँ, अपने ऐप पर जाएँ और बेयरर टोकन कॉपी करें।

2. एक एंडपॉइंट चुनें

   शुरुआती उपयोगकर्ताओं के लिए उपयुक्त इन एंडपॉइंट्स में से किसी एक से शुरू करें:

   Endpoint	यह क्या करता है
   User lookup	यूज़रनेम या ID से उपयोगकर्ता प्रोफ़ाइल प्राप्त करें
   Post lookup	ID से पोस्ट प्राप्त करें
   Recent search	पिछले 7 दिनों की पोस्ट्स खोजें

3. अनुरोध करें

   cURL, Postman या अपने पसंदीदा HTTP क्लाइंट का उपयोग करें:

   # यूज़रनेम से उपयोगकर्ता की जानकारी प्राप्त करें
   curl "https://api.x.com/2/users/by/username/xdevelopers" \
     -H "Authorization: Bearer $BEARER_TOKEN"
   
4. रिस्पॉन्स पार्स करें

   रिस्पॉन्स JSON फ़ॉर्मैट में होते हैं। मुख्य डेटा data फ़ील्ड में होता है:

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

---

फ़ील्ड्स के साथ अधिक डेटा का अनुरोध करें

डिफ़ॉल्ट रूप से, एंडपॉइंट्स न्यूनतम फ़ील्ड्स लौटाते हैं। अतिरिक्त डेटा पाने के लिए fields पैरामीटर का उपयोग करें:

curl "https://api.x.com/2/users/by/username/xdevelopers?user.fields=created_at,description,public_metrics" \
  -H "Authorization: Bearer $BEARER_TOKEN"

रिस्पॉन्स:

{
  "data": {
    "id": "2244994945",
    "name": "X Developers",
    "username": "xdevelopers",
    "created_at": "2013-12-14T04:35:55.000Z",
    "description": "The voice of the X Developer Platform",
    "public_metrics": {
      "followers_count": 570842,
      "following_count": 2048,
      "tweet_count": 14052,
      "listed_count": 1672
    }
  }
}

फ़ील्ड्स के बारे में और जानें →

---

और उदाहरण

किसी पोस्ट को देखें

curl "https://api.x.com/2/tweets/1460323737035677698?tweet.fields=created_at,public_metrics" \
  -H "Authorization: Bearer $BEARER_TOKEN"

हाल की पोस्ट्स खोजें

curl "https://api.x.com/2/tweets/search/recent?query=from:xdevelopers&tweet.fields=created_at" \
  -H "Authorization: Bearer $BEARER_TOKEN"

किसी उपयोगकर्ता की पोस्ट्स प्राप्त करें

curl "https://api.x.com/2/users/2244994945/tweets?max_results=5" \
  -H "Authorization: Bearer $BEARER_TOKEN"

---

cURL के बजाय कोड का इस्तेमाल

Python

import requests

bearer_token = "YOUR_BEARER_TOKEN"
url = "https://api.x.com/2/users/by/username/xdevelopers"

headers = {"Authorization": f"Bearer {bearer_token}"}
response = requests.get(url, headers=headers)

print(response.json())

JavaScript

const bearerToken = "YOUR_BEARER_TOKEN";
const url = "https://api.x.com/2/users/by/username/xdevelopers";

fetch(url, {
  headers: { Authorization: `Bearer ${bearerToken}` }
})
  .then(res => res.json())
  .then(data => console.log(data));

आधिकारिक SDKs

प्रोडक्शन उपयोग के लिए, हम आधिकारिक SDKs की सिफारिश करते हैं:

• Python SDK
• TypeScript SDK

ये प्रमाणीकरण, पेजिनेशन और रेट लिमिटिंग को अपने-आप संभालते हैं।

---

परीक्षण के लिए टूल्स

Postman

हमारे कलेक्शन के साथ विज़ुअल API परीक्षण।

नमूना कोड

कई भाषाओं में उदाहरण।

API संदर्भ

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

---

समस्या निवारण

401 अनधिकृत

• जाँचें कि आपका बेयरर टोकन सही है
• सुनिश्चित करें कि टोकन दोबारा जनरेट नहीं किया गया है
• Authorization हेडर का फ़ॉर्मैट सत्यापित करें: Bearer YOUR_TOKEN

403 निषिद्ध

• हो सकता है कि आपके ऐप को इस एंडपॉइंट का ऐक्सेस न हो
• कुछ endpoints के लिए user-context प्रमाणीकरण (OAuth 1.0a या 2.0) आवश्यक होता है
• डेवलपर कंसोल में अपने ऐप की अनुमतियाँ जाँचें

429 बहुत अधिक अनुरोध

• आपने rate limit पार कर ली है
• दोबारा कोशिश कब करनी है, यह जानने के लिए x-rate-limit-reset हेडर जाँचें
• अपने कोड में exponential backoff लागू करें

पूरा error reference →

---

अगले चरण

प्रमाणीकरण सीखें

उपयोगकर्ता-संदर्भ वाले अनुरोधों के लिए OAuth को समझें।

एंडपॉइंट्स एक्सप्लोर करें

जानें कि आप क्या-क्या बना सकते हैं।

SDK का उपयोग करें

आधिकारिक लाइब्रेरीज़ के साथ तेज़ डेवलपमेंट।

कुछ बनाएँ

क्या बनाया जा सकता है, इसके लिए आइडियाज़।