> ## Documentation Index
> Fetch the complete documentation index at: https://www.ayrshare.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# अपनी स्वयं की X API Key सेट करें

> अपने स्वयं के X (Twitter) API credentials को Ayrshare के साथ जोड़ने के लिए चरण-दर-चरण मार्गदर्शिका

31 मार्च, 2026 को, X ने बदल दिया कि तृतीय-पक्ष प्लेटफ़ॉर्म अपने API तक कैसे पहुँचते हैं। परिणामस्वरूप, Ayrshare के माध्यम से X पर पोस्ट करने वाले प्रत्येक Ayrshare account को अपना स्वयं का X Developer App पंजीकृत करना होगा और हर अनुरोध पर अपनी API Key और API Secret का उपयोग करना होगा।

यह X द्वारा अनिवार्य एक प्लेटफ़ॉर्म-व्यापी परिवर्तन है जो सभी तृतीय-पक्ष उपकरणों को प्रभावित करता है।

<Info>
  **BYO keys प्रति प्लेटफ़ॉर्म एक बार सेट की जाती हैं (account-wide), प्रति ग्राहक या sub-profile नहीं।** आप अपने स्वयं के X account के तहत **एक X Developer App** बनाते हैं, और वही **API Key + API Secret** X के लिए account-wide लागू होते हैं — वे आपके Ayrshare account के तहत X को लिंक करने वाले **हर** sub-profile / end-user के लिए उपयोग किए जाते हैं। यदि आपके पास सैकड़ों sub-profiles वाला Business या Enterprise plan है, तो आपको इस setup को प्रत्येक के लिए दोहराने की आवश्यकता **नहीं** है। आप इसे X प्लेटफ़ॉर्म के लिए एक बार सेट करते हैं, फिर हर अनुरोध पर वही दो headers पास करते हैं।
</Info>

हमने setup प्रक्रिया को यथासंभव सरल बनाने के लिए streamlined किया है, और इसे पूरा करने में 10 मिनट से भी कम समय लगना चाहिए। नीचे हमारी चरण-दर-चरण मार्गदर्शिका का पालन करें, और यदि आपको रास्ते में कोई मदद चाहिए, तो हमारी टीम सहायता के लिए यहाँ है।

## चरण 1: अपना X Developer Account बनाएँ

<Steps>
  <Step title="Developer Console में साइन इन करें">
    [console.x.com](https://console.x.com) पर जाएँ और अपने X account के साथ साइन इन करें। यदि आपको सहायता चाहिए तो [X's getting started guide](https://docs.x.com/x-api/getting-started/getting-access) देखें।

    <img class="center" width="700" src="https://mintcdn.com/ayrshare-docs/qVYhhKC6hYCwYmRp/images/dashboard/x-byo-setup/step1-developer-console.webp?fit=max&auto=format&n=qVYhhKC6hYCwYmRp&q=85&s=58a00543db365d4d889722070643a070" alt="X Developer Console sign-in page" data-path="images/dashboard/x-byo-setup/step1-developer-console.webp" />
  </Step>

  <Step title="Onboarding पूरा करें">
    Developer onboarding पूरा करें और Developer Agreement और नीतियों को स्वीकार करें।
  </Step>

  <Step title="Console तक पहुँचें">
    अब आप X Developer Console में हैं।
  </Step>
</Steps>

## चरण 2: एक App बनाएँ

<Info>
  आप **प्रति Ayrshare account केवल एक X Developer App** बनाते हैं। वही app और उसकी API Key + API Secret बाद में आपके Ayrshare account के तहत लिंक किए गए हर sub-profile / end-user के लिए पुन: उपयोग की जाती हैं। आप प्रति ग्राहक एक नया app नहीं बनाते।
</Info>

<Steps>
  <Step title="Apps पर navigate करें">
    Developer Console में, **Apps** पर navigate करें।

    <img class="center" width="700" src="https://mintcdn.com/ayrshare-docs/qVYhhKC6hYCwYmRp/images/dashboard/x-byo-setup/step2-apps-page.webp?fit=max&auto=format&n=qVYhhKC6hYCwYmRp&q=85&s=36076b8577cb46f4713cad41933bae2f" alt="Apps page in X Developer Console" data-path="images/dashboard/x-byo-setup/step2-apps-page.webp" />
  </Step>

  <Step title="App बनाएँ">
    App dashboard में, **Create App** पर क्लिक करें (विवरण के लिए [X's App setup docs](https://docs.x.com/fundamentals/developer-apps) देखें)। एक app नाम दर्ज करें (सामान्यतः आपका ब्रांड नाम)। जब उपयोगकर्ता अपने X account को कनेक्ट करते हैं तो यह नाम OAuth authorization स्क्रीन में दिखाई देगा।

    <img class="center" width="700" src="https://mintcdn.com/ayrshare-docs/qVYhhKC6hYCwYmRp/images/dashboard/x-byo-setup/step2-create-app.webp?fit=max&auto=format&n=qVYhhKC6hYCwYmRp&q=85&s=dd9627eeb7e58c80f6249dd5cbfb0d4e" alt="Create App button in the X Developer Console" data-path="images/dashboard/x-byo-setup/step2-create-app.webp" />
  </Step>

  <Step title="Environment चुनें">
    Dropdown में **Production** environment चुनें।

    <img class="center" width="700" src="https://mintcdn.com/ayrshare-docs/qVYhhKC6hYCwYmRp/images/dashboard/x-byo-setup/step2-credentials-popup.webp?fit=max&auto=format&n=qVYhhKC6hYCwYmRp&q=85&s=2b111d840665b0b7eb96fc0d9df99f0e" alt="Production environment selection and credentials popup" data-path="images/dashboard/x-byo-setup/step2-credentials-popup.webp" />
  </Step>

  <Step title="प्रारंभिक credentials popup बंद करें">
    X कई credentials generate करेगा। **इन credentials को अनदेखा करें और इस विंडो को बंद करें।**
  </Step>
</Steps>

## चरण 3: App अनुमतियाँ कॉन्फ़िगर करें

<Steps>
  <Step title="अपनी app settings खोलें">
    "Apps" के अंतर्गत, नए app को खोजें (यदि यह प्रकट नहीं होता है तो पेज refresh करें), फिर इसके विवरण देखने के लिए उस पर क्लिक करें।

    <img class="center" width="700" src="https://mintcdn.com/ayrshare-docs/qVYhhKC6hYCwYmRp/images/dashboard/x-byo-setup/step3-app-details.webp?fit=max&auto=format&n=qVYhhKC6hYCwYmRp&q=85&s=41f185aa2ffb4d90f0f9f174597cc4f1" alt="App details page in the X Developer Console" data-path="images/dashboard/x-byo-setup/step3-app-details.webp" />

    **User authentication settings** के अंतर्गत, **Set up** पर क्लिक करें।

    <img class="center" width="700" src="https://mintcdn.com/ayrshare-docs/qVYhhKC6hYCwYmRp/images/dashboard/x-byo-setup/step3-user-auth-settings.webp?fit=max&auto=format&n=qVYhhKC6hYCwYmRp&q=85&s=4faad9d5bc061f442ee0cc605e0aad6a" alt="User authentication settings, click Set up" data-path="images/dashboard/x-byo-setup/step3-user-auth-settings.webp" />
  </Step>

  <Step title="App अनुमतियाँ सेट करें">
    **App permissions** के अंतर्गत, **Read and write and Direct message** चुनें। यह पोस्टिंग और DMs सहित पूर्ण सुविधा समर्थन के लिए आवश्यक है।

    <img class="center" width="700" src="https://mintcdn.com/ayrshare-docs/qVYhhKC6hYCwYmRp/images/dashboard/x-byo-setup/step3-app-permissions.webp?fit=max&auto=format&n=qVYhhKC6hYCwYmRp&q=85&s=57549ea060507af5b99552b6952ef95a" alt="App permissions set to Read and write and Direct message" data-path="images/dashboard/x-byo-setup/step3-app-permissions.webp" />
  </Step>

  <Step title="App प्रकार सेट करें">
    **Type of App** के अंतर्गत, **Web App, Automated App or Bot** चुनें। यह Ayrshare जैसे server-side integrations के लिए सही विकल्प है।

    <img class="center" width="700" src="https://mintcdn.com/ayrshare-docs/qVYhhKC6hYCwYmRp/images/dashboard/x-byo-setup/step3-app-type.webp?fit=max&auto=format&n=qVYhhKC6hYCwYmRp&q=85&s=8609d048548432862ad801113e7b7b8e" alt="Type of App set to Web App, Automated App or Bot" data-path="images/dashboard/x-byo-setup/step3-app-type.webp" />
  </Step>

  <Step title="Callback और website URLs सेट करें">
    **App info** के अंतर्गत:

    * **Callback URL:** निम्नलिखित दोनों callback URLs जोड़ें:
      * `https://profile.ayrshare.com/social-accounts`
      * `https://app.ayrshare.com/social-accounts`
    * **Website URL:** `https://app.ayrshare.com`

    <Warning>
      **इस चरण को न छोड़ें।** ये callback URLs OAuth linking flow के लिए आवश्यक हैं। जब आपके end-users X कनेक्शन को अधिकृत करते हैं, तो X उन्हें linking प्रक्रिया पूरी करने के लिए इनमें से किसी एक URL पर redirect करता है। यदि ये गायब हैं, तो OAuth flow `403 Callback URL not approved` error के साथ विफल होगा।
    </Warning>

    <img class="center" width="700" src="https://mintcdn.com/ayrshare-docs/itktiDewCYTaymFN/images/dashboard/x-byo-setup/step3-app-info-urls.webp?fit=max&auto=format&n=itktiDewCYTaymFN&q=85&s=09d7254aa2d183e2899f95412e97316b" alt="App info form with callback URL and website URL filled in" data-path="images/dashboard/x-byo-setup/step3-app-info-urls.webp" />
  </Step>

  <Step title="अपनी settings save करें">
    **Save** पर क्लिक करें। आप OAuth 2.0 popup को अनदेखा कर सकते हैं, क्योंकि आप केवल OAuth 1.0 keys (API Key और API Secret) में से 2 का उपयोग करेंगे।
  </Step>
</Steps>

<Warning>
  **महत्वपूर्ण: लिंक करने से पहले अनुमतियाँ सेट करें।** आप यहाँ जो अनुमतियाँ चुनते हैं, वे यह निर्धारित करती हैं कि आपका app क्या कर सकता है। यदि आप OAuth के माध्यम से अपने X account को लिंक करने के बाद अनुमतियाँ बदलते हैं, तो आपको फिर से लिंक करना होगा ताकि नया Access Token अद्यतन अनुमतियों को inherit कर सके।

  <img class="center" width="700" src="https://mintcdn.com/ayrshare-docs/qVYhhKC6hYCwYmRp/images/dashboard/x-byo-setup/step3-keys-and-tokens.webp?fit=max&auto=format&n=qVYhhKC6hYCwYmRp&q=85&s=761423c4c27f0c90b480d00f1ff253f7" alt="Keys and tokens page showing OAuth 1.0 keys with permission level" data-path="images/dashboard/x-byo-setup/step3-keys-and-tokens.webp" />
</Warning>

कृपया सुनिश्चित करें कि आप इन 2 keys को store करते हैं:

1. **API Key** (aka Consumer Key, X app पहचानकर्ता)
2. **API Secret** (aka Consumer Secret)

<Info>
  आपको मैन्युअल रूप से Access Tokens generate करने की आवश्यकता **नहीं** है। Ayrshare स्वचालित रूप से इसे संभालता है जब आप OAuth के माध्यम से अपने X account को लिंक करते हैं।
</Info>

## चरण 4: X API Credits खरीदें

X अब credit-आधारित API billing का उपयोग करता है, जिसे developer console के माध्यम से खरीदा जाता है।

<Steps>
  <Step title="Billing पर navigate करें">
    Developer Console में, बाएँ sidebar में **Billing → Credits** पर क्लिक करें।

    <img class="center" width="700" src="https://mintcdn.com/ayrshare-docs/qVYhhKC6hYCwYmRp/images/dashboard/x-byo-setup/step4-billing-credits.webp?fit=max&auto=format&n=qVYhhKC6hYCwYmRp&q=85&s=b104e991f726ec2ecb8cc8274d1889d2" alt="Billing Credits page in X Developer Console" data-path="images/dashboard/x-byo-setup/step4-billing-credits.webp" />
  </Step>

  <Step title="Credits खरीदें">
    Credits खरीदें (न्यूनतम \$5 है, जो सैकड़ों API calls के लिए पर्याप्त है)। प्रत्येक API call एक पैसे का एक अंश है, इसलिए अधिकांश उपयोगकर्ताओं के लिए लागत न्यूनतम होनी चाहिए।

    <img class="center" width="700" src="https://mintcdn.com/ayrshare-docs/qVYhhKC6hYCwYmRp/images/dashboard/x-byo-setup/step4-purchase-credits.webp?fit=max&auto=format&n=qVYhhKC6hYCwYmRp&q=85&s=ae555dc44bcfdfb0d7e4f55237b248ef" alt="Credit purchase page in the X Developer Console" data-path="images/dashboard/x-byo-setup/step4-purchase-credits.webp" />
  </Step>

  <Step title="Auto-recharge सक्षम करें">
    सेवा में व्यवधानों से बचने के लिए आप **auto-recharge** सक्षम कर सकते हैं, और अपने billing cycle में आप जितनी अधिकतम राशि खर्च कर सकते हैं उसे सेट करके अपने spend cap को प्रबंधित कर सकते हैं।

    <img class="center" width="700" src="https://mintcdn.com/ayrshare-docs/qVYhhKC6hYCwYmRp/images/dashboard/x-byo-setup/step4-auto-recharge.webp?fit=max&auto=format&n=qVYhhKC6hYCwYmRp&q=85&s=c9e0f36c379bbd5c47c8b242213eaa6a" alt="Auto-recharge and spend cap settings in X Developer Console" data-path="images/dashboard/x-byo-setup/step4-auto-recharge.webp" />
  </Step>
</Steps>

<Warning>
  **Credits के बिना आपकी API calls विफल हो जाएँगी।** X का API pay-per-use है। यदि आपका credit balance शून्य है, तो हर API अनुरोध "Your enrolled account does not have any credits to fulfill this request." संदेश के साथ `402 CreditsDepleted` error लौटाएगा। इसमें posting, tweets पढ़ना, और user lookups शामिल हैं। अपने integration का परीक्षण करने से पहले credits लोड करें। X के pricing के पूर्ण अद्यतन के लिए [X API Pricing कैसे काम करता है](#how-x-api-pricing-works) देखें।
</Warning>

## चरण 5: अपने Ayrshare API Calls अद्यतन करें

चरण 3 में, आपने इन 2 items को अपने स्वयं के env, config, या secrets manager में सुरक्षित रूप से save किया:

1. **API Key** (aka Consumer Key, X app पहचानकर्ता)
2. **API Secret** (aka Consumer Secret)

अब, अपने Ayrshare API calls के headers में अपने X credentials जोड़ें।

<Info>
  **आपकी keys निजी रहती हैं।** आपकी API Key और API Secret Ayrshare द्वारा store नहीं की जाती हैं।
</Info>

### Header संदर्भ

| Header                        | मान                              |
| ----------------------------- | -------------------------------- |
| `X-Twitter-OAuth1-Api-Key`    | API Key (Consumer Key)           |
| `X-Twitter-OAuth1-Api-Secret` | API Key Secret (Consumer Secret) |

<Warning>
  **यह कैसे बताएँ कि आपकी अनुमतियाँ गलत हैं:**

  * यदि आपकी app permissions गलत तरीके से कॉन्फ़िगर की गई हैं, तो आपका API अनुरोध निम्नलिखित संदेश के साथ `403 Forbidden` error लौटा सकता है: "Your client app is not configured with the appropriate OAuth1 app permissions."

  यदि आप यह error देखते हैं, तो X Developer Console में अपनी app permissions को **Read and write and Direct message** पर अद्यतन करें, फिर OAuth के माध्यम से अपने X account को फिर से लिंक करें ताकि नया Access Token अद्यतन अनुमतियों को inherit कर सके।
</Warning>

### Code उदाहरण

<CodeGroup>
  ```bash cURL theme={"system"}
  curl -X POST https://api.ayrshare.com/api/post \
    -H "Authorization: Bearer YOUR_AYRSHARE_API_KEY" \
    -H "X-Twitter-OAuth1-Api-Key: your_api_key" \
    -H "X-Twitter-OAuth1-Api-Secret: your_api_secret" \
    -H "Content-Type: application/json" \
    -d '{"post": "Hello from my own X App!", "platforms": ["twitter"]}'
  ```

  ```javascript Node.js theme={"system"}
  const response = await fetch("https://api.ayrshare.com/api/post", {
    method: "POST",
    headers: {
      "Authorization": "Bearer YOUR_AYRSHARE_API_KEY",
      "Content-Type": "application/json",
      "X-Twitter-OAuth1-Api-Key": process.env.X_API_KEY,
      "X-Twitter-OAuth1-Api-Secret": process.env.X_API_SECRET,
    },
    body: JSON.stringify({
      post: "Hello from my own X App!",
      platforms: ["twitter"],
    }),
  });
  ```

  ```python Python theme={"system"}
  import os
  import requests

  headers = {
      "Authorization": "Bearer YOUR_AYRSHARE_API_KEY",
      "Content-Type": "application/json",
      "X-Twitter-OAuth1-Api-Key": os.environ["X_API_KEY"],
      "X-Twitter-OAuth1-Api-Secret": os.environ["X_API_SECRET"],
  }

  response = requests.post(
      "https://api.ayrshare.com/api/post",
      headers=headers,
      json={"post": "Hello from my own X App!", "platforms": ["twitter"]},
  )
  ```
</CodeGroup>

आपके मौजूदा automations और workflows तब तक काम करते रहेंगे जब तक आप X को target करने वाले हर अनुरोध में अपनी API Key और API Secret headers शामिल करते हैं।

### मौजूदा Profiles को Migrate करना (Business और Enterprise)

यदि आपके पास sub-profiles हैं जो पहले से ही Ayrshare के माध्यम से X से लिंक हैं, तो उन profiles को BYO keys पर switch करने के बाद अपने X accounts को फिर से लिंक करना होगा। ऐसा इसलिए है क्योंकि मौजूदा access tokens Ayrshare के X app के तहत जारी किए गए थे और आपकी consumer keys के साथ उपयोग नहीं किए जा सकते (OAuth 1.0a signatures उस app से bound हैं जिसने token जारी किया था)।

<Steps>
  <Step title="अपनी keys को generateJWT में शामिल करें">
    अपने [generateJWT](/apis/profiles/generate-jwt#body-parameters-13) call body में `twitterApiKey` और `twitterApiSecret` जोड़ें। इन्हें JWT में embed किए जाने से पहले encrypt किया जाता है और आपके end users के सामने प्रकट नहीं किया जाता है।

    ```json theme={"system"}
    {
      "domain": "your-domain",
      "profileKey": "...",
      "privateKey": "...",
      "twitterApiKey": "YOUR_X_CONSUMER_KEY",
      "twitterApiSecret": "YOUR_X_CONSUMER_SECRET"
    }
    ```

    यह एकमात्र अनुरोध है जहाँ आपकी consumer keys body में जाती हैं। अन्य सभी X अनुरोध ऊपर वर्णित headers का उपयोग करते हैं।
  </Step>

  <Step title="उपयोगकर्ताओं को X फिर से लिंक करने के लिए कहें">
    Keys को शामिल करते हुए JWT generate करने के बाद, आपके उपयोगकर्ताओं को profile linking पेज के माध्यम से अपने X account को reconnect करना होगा। OAuth consent screen अब Ayrshare के बजाय आपका app नाम दिखाएगी।

    इसे streamline करने के लिए, आप कर सकते हैं:

    * [Unlink API](/apis/profiles/unlink-social-network#unlink-a-social-network) के माध्यम से accounts को programmatically अनलिंक करें, फिर उपयोगकर्ताओं से फिर से authorize करने के लिए कहें
    * Fresh login को force करने के लिए generateJWT में [`logout` parameter](/apis/profiles/generate-jwt#param-logout) का उपयोग करें
    * Migration flow के दौरान linking पेज पर केवल X दिखाने के लिए [`allowedSocial`](/apis/profiles/generate-jwt#param-allowed-social) का उपयोग करें
  </Step>

  <Step title="सभी API calls पर headers भेजते रहें">
    फिर से लिंक करने के बाद, हर API call (posting, analytics, comments, आदि) पर `X-Twitter-OAuth1-Api-Key` और `X-Twitter-OAuth1-Api-Secret` headers शामिल करना जारी रखें।
  </Step>
</Steps>

<Info>
  एक बार जब कोई profile आपके X app के तहत फिर से लिंक हो जाता है, तो उस profile के लिए सभी बाद के पोस्ट आपकी credentials का उपयोग करेंगे। आप अपने [X Developer Console](https://console.x.com) में Usage पेज देखकर इसे सत्यापित कर सकते हैं।
</Info>

### अपने Setup को सत्यापित करें

यह पुष्टि करने के लिए कि सब कुछ काम कर रहा है, अपने नए headers के साथ Ayrshare API के माध्यम से एक परीक्षण call करें। [/analytics/social](/apis/analytics/social) endpoint एक अच्छा lightweight परीक्षण है, क्योंकि यह कोई पोस्ट नहीं बनाएगा।

## X API Pricing कैसे काम करता है

पहले, Ayrshare आपकी ओर से X के API उपयोग की लागत को कवर करता था। X के वर्तमान मॉडल के तहत, प्रत्येक Ayrshare ग्राहक अपना स्वयं का X Developer account रखता है और अपने application द्वारा किए गए API अनुरोधों के लिए सीधे X को भुगतान करता है। (प्रति Ayrshare account एक X Developer account, प्रति end-user नहीं। आपके सभी sub-profiles एक ही X Developer account और credit balance साझा करते हैं।)

X का pricing मॉडल pay-per-use है: आप X Developer Console में credits खरीदते हैं, और API अनुरोध किए जाने पर वे deduct हो जाते हैं। कोई अनुबंध या subscriptions की आवश्यकता नहीं है।

सामान्य operations सस्ते हैं। उदाहरण के लिए:

| Operation                             | अनुमानित लागत                                                      |
| ------------------------------------- | ------------------------------------------------------------------ |
| एक पोस्ट बनाना (केवल text)            | \~\$0.01 प्रति पोस्ट                                               |
| Media के साथ एक पोस्ट बनाना           | \~\$0.02 प्रति पोस्ट (media अपलोड और post creation अलग अनुरोध हैं) |
| एक पोस्ट पढ़ना                        | \~\$0.005 प्रति read                                               |
| User lookup                           | \~\$0.01 प्रति lookup                                              |
| एक DM भेजना                           | \~\$0.01 प्रति संदेश                                               |
| DM events पढ़ना                       | \~\$0.01 प्रति event                                               |
| User interactions (follow, like, आदि) | \~\$0.015 प्रति अनुरोध                                             |

संदर्भ के लिए, यदि आप प्रति माह लगभग 100 बार पोस्ट कर रहे हैं, तो आपकी direct X लागत लगभग \$1 होगी, और media वाले पोस्ट प्रति माह लगभग \$2 होंगे।

<Note>
  X की pay-per-use pricing वर्तमान में एक pilot चरण में है। दरें परिवर्तन के अधीन हैं, और अतिरिक्त लागतें पेश की जा सकती हैं। सबसे वर्तमान pricing के लिए हमेशा Developer Console की जाँच करें। [X's pricing information breakdown](https://docs.x.com/x-api/fundamentals/pricing) देखें।
</Note>

हम जानते हैं कि यह एक ऐसी लागत पेश करता है जो पहले मौजूद नहीं थी, और हम इसके बारे में पारदर्शी होना चाहते हैं। साथ ही, यह मॉडल कई लाभों को भी unlock करता है जो पिछले shared-key setup के तहत संभव नहीं थे।

## अपनी स्वयं की X API Key का उपयोग करने के लाभ

अपनी स्वयं की X API credentials का उपयोग करना पिछले shared-key मॉडल की तुलना में अधिक नियंत्रण और विश्वसनीयता प्रदान करता है। इसमें शामिल हैं:

* **Branded OAuth अनुभव:** X पहुँच को अधिकृत करते समय उपयोगकर्ता आपका app नाम और branding देखते हैं।
* **समर्पित rate limits:** आपका API उपयोग आपके स्वयं के X Developer account सीमाओं द्वारा governed है, अन्य Ayrshare उपयोगकर्ताओं से अलग। आप [X Developer Console](https://console.x.com) में अपने उपयोग की निगरानी कर सकते हैं और [X API rate limits documentation](https://developer.x.com/en/docs/x-api/rate-limits) की समीक्षा कर सकते हैं।
* **Credential नियंत्रण:** आपकी API Key और Secret आपके स्वयं के X Developer account में रहते हैं। Ayrshare आपकी secret keys को store नहीं करता है।
* **Portability:** चूँकि उपयोगकर्ता आपके X App के साथ authenticate करते हैं, इसलिए आपका integration पूरी तरह से आपके नियंत्रण में रहता है।
* **Usage दृश्यता:** आपका X Developer dashboard API अनुरोध, rate limits, और credit उपयोग दिखाता है।

X इस मॉडल की आवश्यकता वाला पहला प्लेटफ़ॉर्म है, लेकिन अधिक प्लेटफ़ॉर्म "अपनी स्वयं की API key लाओ" की ओर बढ़ रहे हैं। हम इस क्षमता का विस्तार पूरे Ayrshare में कर रहे हैं, इसलिए developers के पास सभी सोशल प्लेटफ़ॉर्म पर समान नियंत्रण और स्वतंत्रता होगी।

## सुरक्षा

* आपकी API Key और API Secret Ayrshare द्वारा store नहीं की जाती हैं।
* सामान्य सुरक्षा सर्वोत्तम प्रथाओं के लिए, [X's authentication security guide](https://docs.x.com/resources/fundamentals/authentication) देखें।

## FAQ

<AccordionGroup>
  <Accordion title="क्या मुझे हर customer / sub-profile के लिए इसे सेट करना होगा?">
    **नहीं।** आप अपने स्वयं के X account के तहत **एक** X Developer App सेट करते हैं, और वही **API Key + API Secret** आपके Ayrshare account के तहत लिंक किए गए हर sub-profile / end-user के लिए पुन: उपयोग की जाती हैं।

    * आप X Developer App **एक बार** बनाते हैं।
    * आप हर Ayrshare API call पर वही दो headers (`X-Twitter-OAuth1-Api-Key` और `X-Twitter-OAuth1-Api-Secret`) पास करते हैं, चाहे call किस sub-profile के लिए हो।
    * आपके end-users अभी भी प्रत्येक अपने स्वयं के X account को authorize करने के लिए OAuth linking flow के माध्यम से जाते हैं, लेकिन उन्हें अपने स्वयं के X Developer App या API keys की **आवश्यकता नहीं** है। वे आपके app के माध्यम से कनेक्ट होते हैं।
    * सभी sub-profiles एक ही X Developer account, समान rate limits, और समान credit balance साझा करते हैं।

    एकमात्र समय जब आप keys को प्रति-profile handle करते हैं, वह migration के दौरान [generateJWT](/apis/profiles/generate-jwt) body में होता है, जो अभी भी आपकी वही दो keys हैं, बस linking पेज पर वितरित की जाती हैं ताकि end-users आपके app के तहत फिर से authorize कर सकें।
  </Accordion>

  <Accordion title="क्या X API key की आवश्यकता अभी सक्रिय है?">
    हाँ। 31 मार्च, 2026 से, Ayrshare के माध्यम से सभी X operations के लिए आपकी स्वयं की X API credentials आवश्यक हैं। यदि आपने अभी तक अपना X Developer account सेट नहीं किया है, तो ऊपर दिए गए चरणों का पालन करें।
  </Accordion>

  <Accordion title="यदि मैं Ayrshare में अपनी X API key नहीं जोड़ता हूँ तो क्या होगा?">
    Ayrshare के माध्यम से X पर पोस्ट करने के लिए आपकी स्वयं की X API credentials आवश्यक हैं। वैध BYO credentials के बिना अनुरोध अस्वीकार कर दिए जाते हैं। अन्य प्लेटफ़ॉर्म्स (Instagram, LinkedIn, Facebook, TikTok, आदि) पर पोस्ट करना अप्रभावित है।
  </Accordion>

  <Accordion title="X API की लागत कितनी है?">
    X प्रति API call शुल्क लेता है। एक पोस्ट बनाने की लागत लगभग \$0.01 है, और एक पोस्ट पढ़ने की लागत लगभग \$0.005 है। उदाहरण के लिए, प्रति माह 100 पोस्ट प्रकाशित करने की लागत लगभग \$1 होगी। पूर्ण विवरण के लिए [X's pricing page](https://docs.x.com/x-api/fundamentals/pricing) देखें।
  </Accordion>

  <Accordion title="क्या यह मेरे Ayrshare subscription मूल्य को बदलता है?">
    नहीं। आपका Ayrshare subscription मूल्य वही रहता है। एकमात्र अतिरिक्त लागत X API उपयोग शुल्क है जो X द्वारा आपके developer account के माध्यम से सीधे बिल किया जाता है।
  </Accordion>

  <Accordion title="क्या Ayrshare मेरी X API credentials को store करता है?">
    नहीं। आपकी API Key और API Secret Ayrshare द्वारा store नहीं की जाती हैं। सामान्य सुरक्षा सर्वोत्तम प्रथाओं के लिए, [X's authentication security guide](https://docs.x.com/resources/fundamentals/authentication) देखें।
  </Accordion>

  <Accordion title="मेरे पास पहले से ही एक X Developer account है। क्या मैं अपनी मौजूदा key का उपयोग कर सकता हूँ?">
    हाँ। आप अपने मौजूदा X App का उपयोग कर सकते हैं जब तक कि इसमें "Read and write" अनुमतियाँ सक्षम हों (और यदि आप DM सुविधाओं का उपयोग करते हैं तो Direct Messages)।

    आपको X Developer Console के Keys and tokens अनुभाग से अपनी API Key (Consumer Key) और API Secret (Consumer Secret) की आवश्यकता होगी। OAuth के माध्यम से अपने X account को लिंक करें, फिर अपने Ayrshare API अनुरोधों में इन 2 headers को शामिल करें।

    यदि आपने प्रारंभिक setup के बाद से अपनी app permissions बदली हैं, तो अपने X account को फिर से लिंक करें ताकि Access Token अद्यतन अनुमतियों को inherit कर सके।
  </Accordion>

  <Accordion title="X Developer Portal कई credentials दिखाता है। मुझे वास्तव में किनकी आवश्यकता है?">
    आपको अपनी API Key (Consumer Key) और API Secret (Consumer Secret) की आवश्यकता है। ऊपर [header reference table](#header-reference) देखें कि प्रत्येक Ayrshare header से किस पर mapping है। आप Client ID, Client Secret, Bearer Token, Access Token, और Access Token Secret को अनदेखा कर सकते हैं।
  </Accordion>

  <Accordion title="'API Key' और 'Client ID' के बीच क्या अंतर है?">
    वे विभिन्न authentication methods के लिए पूरी तरह से अलग credentials हैं:

    * **API Key** (जिसे "Consumer Key" भी कहा जाता है) OAuth 1.0a के लिए है। API Key (Consumer Key) + API Secret वही है जिसका Ayrshare उपयोग करता है। यह सभी X सुविधाओं के साथ काम करता है, tokens कभी expire नहीं होते, और कोई refresh logic आवश्यक नहीं है।
    * **Client ID** OAuth 2.0 के लिए है। आपको Ayrshare के लिए इसकी आवश्यकता नहीं है। OAuth 2.0 tokens थोड़े समय बाद expire हो जाते हैं और refresh token प्रबंधन की आवश्यकता होती है।

    Ayrshare के लिए, आपको केवल अपनी API Key और API Secret की आवश्यकता है। आप Client ID, Client Secret, और Bearer Token को अनदेखा कर सकते हैं।
  </Accordion>

  <Accordion title="OAuth 1.0a क्यों और OAuth 2.0 क्यों नहीं?">
    OAuth 2.0 access tokens हर 2 घंटे में expire होते हैं और X के refresh tokens single-use होते हैं (प्रत्येक refresh पुराने token को अमान्य कर देता है)। यह stateless BYO मॉडल का समर्थन करना असंभव बनाता है, विशेष रूप से scheduled posts के लिए। OAuth 1.0a tokens कभी expire नहीं होते, सभी X सुविधाओं के साथ काम करते हैं, और शून्य token प्रबंधन की आवश्यकता होती है।
  </Accordion>

  <Accordion title="क्या मेरे मौजूदा उपयोगकर्ताओं को अपने X accounts को फिर से लिंक करने की आवश्यकता है?">
    हाँ। यदि आपके उपयोगकर्ताओं ने BYO keys सेट करने से पहले Ayrshare के माध्यम से X को लिंक किया था, तो उन्हें फिर से कनेक्ट करना होगा। मौजूदा access tokens Ayrshare के X app के तहत जारी किए गए थे और आपकी consumer keys के साथ काम नहीं करेंगे। चरण-दर-चरण प्रक्रिया के लिए ऊपर [मौजूदा Profiles को Migrate करना](#migrating-existing-profiles-business--enterprise) देखें।
  </Accordion>

  <Accordion title="क्या यह परिवर्तन Instagram, LinkedIn, या अन्य प्लेटफ़ॉर्म्स पर पोस्ट करने को प्रभावित करता है?">
    नहीं। यह परिवर्तन केवल X पर पोस्ट करने को प्रभावित करता है। Ayrshare में अन्य सभी प्लेटफ़ॉर्म integrations हमेशा की तरह काम करना जारी रखते हैं।
  </Accordion>

  <Accordion title="X पर RSS/Feed auto-posting के बारे में क्या?">
    X पर RSS auto-posting अब समर्थित नहीं है। RSS feeds स्वचालित रूप से एक schedule पर चलते हैं, लेकिन bring-your-own API key मॉडल को प्रत्येक API अनुरोध के साथ credentials प्रदान करने की आवश्यकता होती है। इसके कारण, RSS feeds पोस्ट भेजे जाने पर authenticate नहीं कर सकते।

    यदि आपने पहले X पर पोस्ट करने के लिए RSS का उपयोग किया है, तो हम [scheduled posts](/apis/post/overview#schedule-posts) या आपकी credentials शामिल करने वाले direct API calls पर switch करने की अनुशंसा करते हैं। अन्य सभी प्लेटफ़ॉर्म्स पर RSS auto-posting अपरिवर्तित है।
  </Accordion>

  <Accordion title="मुझे 402 &#x22;CreditsDepleted&#x22; error क्यों मिल रहा है?">
    इसका मतलब है कि आपके X Developer account में कोई API credits उपलब्ध नहीं हैं। [console.x.com](https://console.x.com) → **Billing → Credits** पर जाएँ और credits खरीदें। यहाँ तक कि \$5 भी सैकड़ों API calls के लिए पर्याप्त हैं। एक बार credits लोड होने के बाद, अपना अनुरोध पुन: प्रयास करें।
  </Accordion>

  <Accordion title="मुझे 403 &#x22;Forbidden: OAuth1 App Permissions&#x22; error क्यों मिल रहा है?">
    आपके Access Token में सही अनुमतियाँ नहीं हैं। यह आमतौर पर दो चीजों में से एक का मतलब है:

    1. **आपकी app permissions "Read" पर सेट हैं "Read and write" नहीं।** Developer Console में अपने app की Settings पर जाएँ और इसे **Read and write and Direct message** में बदलें।
    2. **आपने अपने X account को लिंक करने के बाद अनुमतियाँ बदल दीं।** Access Tokens उन अनुमतियों को रखते हैं जिनके साथ वे बनाए गए थे। OAuth के माध्यम से अपने X account को फिर से लिंक करें ताकि नया token अद्यतन अनुमतियों को inherit कर सके।
  </Accordion>

  <Accordion title="यदि मुझे इसे सेट करने में मदद चाहिए तो क्या?">
    हमारी support टीम मदद करने में खुश है। यदि सेटअप के दौरान आपके पास कोई प्रश्न है या समस्याओं का सामना करते हैं, तो कृपया [support@ayrshare.com](mailto:support@ayrshare.com) के माध्यम से संपर्क करें, और हम आपको प्रक्रिया के माध्यम से चलेंगे।
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="मुझे गायब headers के बारे में 400 error मिल रहा है">
    सुनिश्चित करें कि आप दोनों आवश्यक headers भेज रहे हैं:

    * `X-Twitter-OAuth1-Api-Key`
    * `X-Twitter-OAuth1-Api-Secret`

    यदि आप pair-mismatch error देखते हैं (जैसे, "You provided Api-Key but not Api-Secret"), तो इसका मतलब है कि दोनों में से एक गायब है। दोनों हमेशा आवश्यक हैं।

    Error संदेश आपको बताएगा कि कौन सा विशिष्ट header गायब है।
  </Accordion>

  <Accordion title={'मुझे 403 error मिल रहा है: "Callback URL not approved"'}>
    यदि आप अपने X account को लिंक करने का प्रयास करते समय यह error देखते हैं, तो सुनिश्चित करें कि आपने अपनी X Developer App settings (Authentication settings > Callback URI / Redirect URL के तहत) में आवश्यक callback URLs जोड़े हैं:

    * `https://profile.ayrshare.com/social-accounts`
    * `https://app.ayrshare.com/social-accounts`

    ऊपर [Callback URL setup step](#step-3-configure-app-permissions) देखें।
  </Accordion>

  <Accordion title={'मुझे 402 error मिल रहा है: "CreditsDepleted"'}>
    आपके X Developer account में कोई API credits लोड नहीं हैं। [console.x.com](https://console.x.com) → **Billing → Credits** पर जाएँ और credits खरीदें। यहाँ तक कि \$5 भी सैकड़ों API calls के लिए पर्याप्त हैं।
  </Accordion>

  <Accordion title={'मुझे 403 error मिल रहा है: "oauth1 app permissions"'}>
    आपके Access Token में सही अनुमतियाँ नहीं हैं। इसका आमतौर पर मतलब है:

    1. **आपकी app permissions "Read" पर सेट हैं "Read and write" नहीं।** Developer Console में अपने app की Settings पर जाएँ और इसे **Read and write and Direct message** में बदलें।
    2. **आपने अपने X account को लिंक करने के बाद अनुमतियाँ बदल दीं।** Access Tokens उन अनुमतियों को रखते हैं जिनके साथ वे बनाए गए थे। OAuth के माध्यम से अपने X account को फिर से लिंक करें ताकि नया token अद्यतन अनुमतियों को inherit कर सके।
  </Accordion>
</AccordionGroup>

## सहायता चाहिए?

यदि आपके पास अपनी X API key सेट करते समय कोई प्रश्न हैं या समस्याओं का सामना करते हैं, तो हमारी engineering टीम मदद करने में खुश है। आप किसी भी समय [support@ayrshare.com](mailto:support@ayrshare.com) पर हमसे संपर्क कर सकते हैं।
