मुख्य सामग्री पर जाएं

Documentation Index

Fetch the complete documentation index at: https://generaltranslation.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

ऐप्स आपके API क्रेडेंशियल्स को रखने के कंटेनर होते हैं। हर ऐप की अपनी कुंजियाँ, टोकन और सेटिंग्स होती हैं।

​
ऐप क्रेडेंशियल

जब आप एक ऐप बनाते हैं, तो आप ये क्रेडेंशियल जनरेट कर सकते हैं:
क्रेडेंशियलउपयोग
API Key & SecretOAuth 1.0a के साथ प्रमाणित करें। अनुरोधों पर हस्ताक्षर करने या उपयोगकर्ता टोकन जनरेट करने के लिए इस्तेमाल होता है।
Access Token & Secretअपने खाते की ओर से अनुरोध करें (OAuth 1.0a)।
Client ID & SecretOAuth 2.0 के साथ प्रमाणित करें। ऑथराइज़ेशन कोड फ़्लो के लिए इस्तेमाल होता है।
Bearer Tokenसार्वजनिक डेटा एंडपॉइंट के लिए केवल-ऐप प्रमाणीकरण।
नए प्रोजेक्ट के लिए OAuth 2.0 चुनें। यह अधिक सूक्ष्म स्कोप प्रदान करता है और X API v2 के user-context एंडपॉइंट के लिए आवश्यक है।

​
एक ऐप बनाना

1

डेवलपर कंसोल खोलें

console.x.com पर जाएँ और साइन इन करें।
2

Create App पर क्लिक करें

अपने ऐप के लिए नाम, विवरण और उपयोग का उद्देश्य दर्ज करें।
3

क्रेडेंशियल जनरेट करें

ऐप बनने के बाद, अपनी ज़रूरत के अनुसार keys और tokens जनरेट करें।
4

सुरक्षित रूप से सहेजें

क्रेडेंशियल तुरंत सहेज लें—वे केवल एक बार दिखाए जाते हैं।

​
ऐप अनुमतियाँ (OAuth 1.0a)

OAuth 1.0a ऐप्स के लिए अनुमति के तीन स्तर होते हैं:
  • पोस्ट्स, उपयोगकर्ताओं और सार्वजनिक डेटा को देखें
  • पोस्ट, लाइक या किसी भी चीज़ में बदलाव नहीं कर सकते
  • डायरेक्ट मैसेजेस ऐक्सेस नहीं कर सकते
अनुमतियाँ बदलने पर, अपडेट किए गए स्कोप वाले नए टोकन पाने के लिए उपयोगकर्ताओं को आपके ऐप को फिर से अधिकृत करना होगा।

​
OAuth 2.0 ऐप के प्रकार

OAuth 2.0 कॉन्फ़िगर करते समय, अपने ऐप का type चुनें:
प्रकारक्लाइंटउपयोग
वेब ऐपगोपनीयसर्वर-साइड ऐप्लिकेशन, जो secrets को सुरक्षित रूप से स्टोर कर सकते हैं
ऑटोमेटेड ऐप / बॉटगोपनीयसर्वर पर चलने वाले बॉट और ऑटोमेटेड सेवाएँ
नेटिव ऐपसार्वजनिकमोबाइल या डेस्कटॉप ऐप, जो secrets को सुरक्षित नहीं रख सकते
सिंगल पेज ऐपसार्वजनिकब्राउज़र-आधारित JavaScript ऐप
गोपनीय क्लाइंट्स को Client Secret मिलता है। सार्वजनिक क्लाइंट्स केवल PKCE का उपयोग करते हैं।

​
कॉलबैक URL

OAuth फ़्लो के लिए कॉलबैक URL (redirect URI) आवश्यक हैं। उपयोगकर्ता द्वारा आपके ऐप को अधिकृत करने के बाद, उन्हें ऑथराइज़ेशन कोड के साथ आपके कॉलबैक URL पर पुनर्निर्देशित किया जाता है।

​
आवश्यकताएँ

  • डेवलपर कंसोल में अपने ऐप की allowlist में कॉलबैक URLs जोड़ें
  • URLs बिल्कुल सटीक रूप से मेल खाने चाहिए (अंत में आने वाले slash सहित)
  • प्रति ऐप अधिकतम 10 कॉलबैक URLs
  • production में https:// का उपयोग करें
  • local development के लिए http://127.0.0.1 का उपयोग करें (localhost नहीं)

​
निषिद्ध प्रोटोकॉल

इन प्रोटोकॉल का उपयोग नहीं किया जा सकता: javascript, data, file, ftp, mailto, telnet, और अन्य गैर-मानक स्कीम।
vbscript, javascript, vbs, data, mocha, keyword, livescript, ftp, file, gopher, acrobat, callto, daap, itpc, itms, firefoxurl, hcp, ldap, mailto, mmst, mmsu, msbd, rtsp, mso-offdap, snews, news, nntp, outlook, stssync, rlogin, telnet, tn3270, shell, sip

​
सर्वोत्तम तरीके

अलग-अलग ऐप्स इस्तेमाल करें

डेवलपमेंट, स्टेजिंग और प्रोडक्शन के लिए अलग-अलग ऐप्स बनाएं।

क्रेडेंशियल्स बदलते रहें

समय-समय पर कुंजियां फिर से जनरेट करें, और अगर इनके समझौता हो जाने का संदेह हो, तो भी ऐसा करें।

न्यूनतम अनुमतियाँ

केवल उन्हीं अनुमतियों का अनुरोध करें जिनकी आपके ऐप को वास्तव में ज़रूरत है।

उपयोग की निगरानी करें

API उपयोग को ट्रैक करने के लिए डेवलपर कंसोल नियमित रूप से जांचें।

​
स्वचालित अकाउंट लेबल

यदि आपका ऐप किसी बॉट अकाउंट को चलाता है, तो आप उसे स्वचालित के तौर पर लेबल कर सकते हैं:
  1. अपने बॉट अकाउंट की Settings पर जाएँ
  2. Your account → Automation चुनें
  3. अपने प्रबंधक अकाउंट को लिंक करें
इससे उपयोगकर्ताओं का भरोसा बढ़ता है और आपका बॉट स्पैम से अलग पहचाना जाता है।

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

सुनिश्चित करें कि आपका कॉलबैक URL डेवलपर कंसोल में ठीक उसी तरह पंजीकृत है, जिसमें प्रोटोकॉल और अंत में लगने वाले किसी भी slash सहित सब कुछ शामिल हो। URL को query parameter के रूप में पास करते समय उसे HTTP-encode करें।
{
  "errors": [{
    "code": 415,
    "message": "Callback URL not approved for this client application."
  }]
}
अगर आपका ऐप निलंबित दिखता है, तो X प्लेटफ़ॉर्म टीम से आए सूचना संदेश के लिए अपना ईमेल देखें। अपील करने के लिए Platform Help Form का उपयोग करें।