मुख्य सामग्री पर जाएं
इस पेज में सूची एंडपॉइंट्स को इंटीग्रेट करने के लिए उपयोगी टूल और मुख्य अवधारणाओं के बारे में बताया गया है।

उपयोगी टूल

इस एंडपॉइंट को इंटीग्रेट करने में मदद करने वाली कुछ प्रमुख अवधारणाओं पर जाने से पहले, हमारा सुझाव है कि आप इनसे परिचित हो जाएँ:

Postman

Postman एक बेहतरीन टूल है, जिसका उपयोग आप किसी एंडपॉइंट को टेस्ट करने के लिए कर सकते हैं। हर Postman अनुरोध में सभी path और body पैरामीटर शामिल होते हैं, ताकि आप जल्दी से समझ सकें कि आपके लिए क्या उपलब्ध है। हमारी Postman collections के बारे में अधिक जानने के लिए, कृपया हमारा “Postman का उपयोग करना” पेज देखें।

कोड नमूने

क्या आप अपनी पसंदीदा कोडिंग भाषा में कुछ कोड के साथ इस एंडपॉइंट को सेट अप करना चाहते हैं? हमारे Github page पर कई अलग-अलग कोड नमूने उपलब्ध हैं, जिन्हें आप शुरुआती बिंदु के रूप में इस्तेमाल कर सकते हैं।

तृतीय-पक्ष लाइब्रेरी

शुरुआत करने में मदद के लिए हमारे समुदाय की तृतीय-पक्ष लाइब्रेरी में से किसी एक का उपयोग करें। सही version tag देखकर आप ऐसी लाइब्रेरी ढूँढ़ सकते हैं जो v2 एंडपॉइंट्स के साथ काम करती हो।

मुख्य अवधारणाएँ

प्रमाणीकरण

सभी X API v2 एंडपॉइंट के लिए यह आवश्यक है कि आप अपने अनुरोधों को क्रेडेंशियल्स के एक सेट से प्रमाणित करें, जिन्हें keys और tokens भी कहा जाता है। इन विशेष एंडपॉइंट के लिए OAuth 1.0a User Context का उपयोग आवश्यक है, यानी सफल अनुरोध करने के लिए आपको API keys और उपयोगकर्ता एक्सेस टोकन के एक सेट का उपयोग करना होगा। Access Tokens उस उपयोगकर्ता से संबद्ध होने चाहिए, जिसकी ओर से आप अनुरोध कर रहे हैं। अगर आप किसी दूसरे उपयोगकर्ता के लिए Access Tokens का एक सेट जनरेट करना चाहते हैं, तो उसे 3-legged OAuth flow का उपयोग करके आपके ऐप को अधिकृत या प्रमाणित करना होगा। कृपया ध्यान दें कि OAuth 1.0a का उपयोग करना थोड़ा जटिल हो सकता है। अगर आप इस प्रमाणीकरण विधि से परिचित नहीं हैं, तो हम सलाह देते हैं कि अपने अनुरोधों को सही तरीके से प्रमाणित करने के लिए आप किसी लाइब्रेरी या Postman जैसे टूल का उपयोग करें।

डेवलपर कंसोल, प्रोजेक्ट, और डेवलपर ऐप्स

X API v2 एंडपॉइंट्स के साथ काम करने वाले प्रमाणीकरण क्रेडेंशियल्स का एक सेट प्राप्त करने के लिए, आपको डेवलपर खाते के लिए साइन अप करना होगा, उस खाते के भीतर एक प्रोजेक्ट सेट अप करना होगा, और उस प्रोजेक्ट के भीतर एक डेवलपर ऐप बनाना होगा। इसके बाद, आप अपने डेवलपर ऐप में अपनी कुंजियाँ और टोकन पा सकते हैं।

रेट लिमिट्स

हर दिन, हज़ारों डेवलपर X API को अनुरोध भेजते हैं। इन अनुरोधों की बहुत अधिक संख्या को प्रबंधित करने में मदद के लिए, प्रत्येक एंडपॉइंट पर रेट लिमिट्स लागू की जाती हैं, जो उन अनुरोधों की संख्या सीमित करती हैं जिन्हें आप अपने ऐप की ओर से या किसी प्रमाणीकृत उपयोगकर्ता की ओर से कर सकते हैं। इन एंडपॉइंट्स पर उपयोगकर्ता-स्तर की रेट लिमिट्स लागू होती हैं। इसका मतलब है कि जिस प्रमाणीकृत उपयोगकर्ता की ओर से आप अनुरोध कर रहे हैं, वह किसी भी डेवलपर ऐप में इस एंडपॉइंट को केवल एक निश्चित संख्या में ही कॉल कर सकता है। नीचे दी गई तालिका प्रत्येक एंडपॉइंट के लिए रेट लिमिट्स दिखाती है।
एंडपॉइंटHTTP विधिरेट लिमिट
/2/listsPOST15 मिनट में 300 अनुरोध
/2/lists/:idDELETE / PUT15 मिनट में 300 अनुरोध

कोड उदाहरण

सूची बनाएँ

cURL
curl -X POST "https://api.x.com/2/lists" \
  -H "Authorization: OAuth ..." \
  -H "Content-Type: application/json" \
  -d '{"name": "My List", "description": "A list of interesting accounts"}'

एक सूची अपडेट करें

cURL
curl -X PUT "https://api.x.com/2/lists/123456789" \
  -H "Authorization: OAuth ..." \
  -H "Content-Type: application/json" \
  -d '{"name": "Updated List Name"}'