> ## Documentation Index
> Fetch the complete documentation index at: https://generaltranslation.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

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

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

export const Button = ({href, children}) => {
  return <div className="not-prose group">
    <a href={href}>
      <button className="flex items-center space-x-2.5 py-1 px-4 bg-primary-dark dark:bg-white text-white dark:text-gray-950 rounded-full group-hover:opacity-[0.9] font-medium">
        <span>
          {children}
        </span>
        <svg width="3" height="24" viewBox="0 -9 3 24" class="h-6 rotate-0 overflow-visible"><path d="M0 0L3 3L0 6" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round"></path></svg>
      </button>
    </a>
  </div>;
};

यह गाइड आपको अपना पहला X API अनुरोध करने का तरीका बताती है। शुरू करने से पहले आपके पास [ऐप क्रेडेंशियल्स वाला एक डेवलपर खाता](/hi/x-api/getting-started/getting-access) होना चाहिए।

***

<div id="quick-start-with-curl">
  ## cURL के साथ त्वरित शुरुआत
</div>

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

```bash theme={null}
curl "https://api.x.com/2/users/by/username/xdevelopers" \
  -H "Authorization: Bearer $BEARER_TOKEN"
```

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

```json theme={null}
{
  "data": {
    "id": "2244994945",
    "name": "X Developers",
    "username": "xdevelopers"
  }
}
```

***

<div id="step-by-step-guide">
  ## चरण-दर-चरण मार्गदर्शिका
</div>

<Steps>
  <Step title="अपना बेयरर टोकन प्राप्त करें">
    [डेवलपर कंसोल](https://console.x.com) में जाएँ, अपने ऐप पर जाएँ और बेयरर टोकन कॉपी करें।
  </Step>

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

    | Endpoint                                             | यह क्या करता है                                     |
    | :--------------------------------------------------- | :-------------------------------------------------- |
    | [User lookup](/hi/x-api/users/lookup/introduction)   | यूज़रनेम या ID से उपयोगकर्ता प्रोफ़ाइल प्राप्त करें |
    | [Post lookup](/hi/x-api/posts/lookup/introduction)   | ID से पोस्ट प्राप्त करें                            |
    | [Recent search](/hi/x-api/posts/search/introduction) | पिछले 7 दिनों की पोस्ट्स खोजें                      |
  </Step>

  <Step title="अनुरोध करें">
    cURL, Postman या अपने पसंदीदा HTTP क्लाइंट का उपयोग करें:

    ```bash theme={null}
    # यूज़रनेम से उपयोगकर्ता की जानकारी प्राप्त करें
    curl "https://api.x.com/2/users/by/username/xdevelopers" \
      -H "Authorization: Bearer $BEARER_TOKEN"
    ```
  </Step>

  <Step title="रिस्पॉन्स पार्स करें">
    रिस्पॉन्स JSON फ़ॉर्मैट में होते हैं। मुख्य डेटा `data` फ़ील्ड में होता है:

    ```json theme={null}
    {
      "data": {
        "id": "2244994945",
        "name": "X Developers",
        "username": "xdevelopers"
      }
    }
    ```
  </Step>
</Steps>

***

<div id="request-more-data-with-fields">
  ## फ़ील्ड्स के साथ अधिक डेटा का अनुरोध करें
</div>

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

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

रिस्पॉन्स:

```json theme={null}
{
  "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
    }
  }
}
```

[फ़ील्ड्स के बारे में और जानें →](/hi/x-api/fundamentals/fields)

***

<div id="more-examples">
  ## और उदाहरण
</div>

<Tabs>
  <Tab title="किसी पोस्ट को देखें">
    ```bash theme={null}
    curl "https://api.x.com/2/tweets/1460323737035677698?tweet.fields=created_at,public_metrics" \
      -H "Authorization: Bearer $BEARER_TOKEN"
    ```
  </Tab>

  <Tab title="हाल की पोस्ट्स खोजें">
    ```bash theme={null}
    curl "https://api.x.com/2/tweets/search/recent?query=from:xdevelopers&tweet.fields=created_at" \
      -H "Authorization: Bearer $BEARER_TOKEN"
    ```
  </Tab>

  <Tab title="किसी उपयोगकर्ता की पोस्ट्स प्राप्त करें">
    ```bash theme={null}
    curl "https://api.x.com/2/users/2244994945/tweets?max_results=5" \
      -H "Authorization: Bearer $BEARER_TOKEN"
    ```
  </Tab>
</Tabs>

***

<div id="using-code-instead-of-curl">
  ## cURL के बजाय कोड का इस्तेमाल
</div>

<Tabs>
  <Tab title="Python">
    ```python theme={null}
    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())
    ```
  </Tab>

  <Tab title="JavaScript">
    ```javascript theme={null}
    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));
    ```
  </Tab>

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

    * [Python SDK](/hi/xdks/python/overview)
    * [TypeScript SDK](/hi/xdks/typescript/overview)

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

***

<div id="tools-for-testing">
  ## परीक्षण के लिए टूल्स
</div>

<CardGroup cols={3}>
  <Card title="Postman" icon="server" href="/hi/tutorials/postman-getting-started">
    हमारे कलेक्शन के साथ विज़ुअल API परीक्षण।
  </Card>

  <Card title="नमूना कोड" icon="github" href="https://github.com/xdevplatform/Twitter-API-v2-sample-code">
    कई भाषाओं में उदाहरण।
  </Card>

  <Card title="API संदर्भ" icon="code" href="/hi/x-api/posts/lookup/introduction">
    एंडपॉइंट का पूरा दस्तावेज़ीकरण।
  </Card>
</CardGroup>

***

<div id="troubleshooting">
  ## समस्या निवारण
</div>

<Accordion title="401 अनधिकृत">
  * जाँचें कि आपका बेयरर टोकन सही है
  * सुनिश्चित करें कि टोकन दोबारा जनरेट नहीं किया गया है
  * `Authorization` हेडर का फ़ॉर्मैट सत्यापित करें: `Bearer YOUR_TOKEN`
</Accordion>

<Accordion title="403 निषिद्ध">
  * हो सकता है कि आपके ऐप को इस एंडपॉइंट का ऐक्सेस न हो
  * कुछ endpoints के लिए user-context प्रमाणीकरण (OAuth 1.0a या 2.0) आवश्यक होता है
  * डेवलपर कंसोल में अपने ऐप की अनुमतियाँ जाँचें
</Accordion>

<Accordion title="429 बहुत अधिक अनुरोध">
  * आपने rate limit पार कर ली है
  * दोबारा कोशिश कब करनी है, यह जानने के लिए `x-rate-limit-reset` हेडर जाँचें
  * अपने कोड में exponential backoff लागू करें
</Accordion>

[पूरा error reference →](/hi/x-api/fundamentals/response-codes-and-errors)

***

<div id="next-steps">
  ## अगले चरण
</div>

<CardGroup cols={2}>
  <Card title="प्रमाणीकरण सीखें" icon="key" href="/hi/resources/fundamentals/authentication/overview">
    उपयोगकर्ता-संदर्भ वाले अनुरोधों के लिए OAuth को समझें।
  </Card>

  <Card title="एंडपॉइंट्स एक्सप्लोर करें" icon="compass" href="/hi/x-api/posts/search/introduction">
    जानें कि आप क्या-क्या बना सकते हैं।
  </Card>

  <Card title="SDK का उपयोग करें" icon="cube" href="/hi/xdks/overview">
    आधिकारिक लाइब्रेरीज़ के साथ तेज़ डेवलपमेंट।
  </Card>

  <Card title="कुछ बनाएँ" icon="hammer" href="/hi/x-api/what-to-build">
    क्या बनाया जा सकता है, इसके लिए आइडियाज़।
  </Card>
</CardGroup>