एकीकरण मार्गदर्शिका
अवलोकन
इस पृष्ठ में पोस्ट काउंट एंडपॉइंट्स को एकीकृत करने के लिए उपयोगी टूल और प्रमुख अवधारणाओं के बारे में बताया गया है।
कुछ मुख्य अवधारणाओं पर जाने से पहले, हम सुझाव देते हैं कि आप इन endpoints की कार्यक्षमता का परीक्षण शुरू करने के लिए नीचे दिए गए टूल या code samples में से किसी एक का उपयोग करें।
क्या आप अपनी पसंदीदा कोडिंग भाषा में कुछ कोड के साथ इन endpoints के लिए सेटअप करना चाहते हैं? हमने कई तरह के कोड नमूने उपलब्ध कराए हैं, जिन्हें आप हमारे GitHub page पर शुरुआती आधार के रूप में इस्तेमाल कर सकते हैं, जिनमें एक Python client भी शामिल है।
शुरुआत करने में मदद के लिए हमारी कई समुदाय-निर्मित तृतीय-पक्ष लाइब्रेरी में से किसी एक का उपयोग करें। उपयुक्त वर्शन टैग देखकर आप ऐसी लाइब्रेरी ढूँढ़ सकते हैं जो v2 endpoints के साथ काम करती हो।
Postman एक बेहतरीन टूल है, जिसका उपयोग आप इन endpoints को टेस्ट करने के लिए कर सकते हैं। हर Postman अनुरोध में संबंधित endpoint के सभी parameters शामिल होते हैं, ताकि आप जल्दी समझ सकें कि आपके लिए क्या उपलब्ध है। हमारी Postman collections के बारे में अधिक जानने के लिए, कृपया हमारा Postman का उपयोग पेज देखें।
सभी X API v2 एंडपॉइंट्स के लिए अनुरोधों को प्रमाणीकृत किया जाना आवश्यक है। इसके लिए क्रेडेंशियल्स का एक सेट चाहिए, जिन्हें keys और tokens भी कहा जाता है। इस विशेष एंडपॉइंट के लिए OAuth 2.0 बेयरर टोकन का उपयोग आवश्यक है, यानी सफल अनुरोध करने के लिए आपको एक बेयरर टोकन पास करना होगा। आप बेयरर टोकन को सीधे किसी डेवलपर ऐप के भीतर से जनरेट कर सकते हैं, या POST oauth2/token एंडपॉइंट का उपयोग करके भी इसे जनरेट कर सकते हैं।
किसी भी X API v2 endpoint के साथ काम करने के लिए, आपके पास एक डेवलपर खाता होना चाहिए, उस खाते के भीतर एक Project सेट अप होना चाहिए, और उस Project के भीतर एक developer App बनाया होना चाहिए। उस developer App में मौजूद आपकी keys और tokens हाल के पोस्ट काउंट endpoints के लिए काम करेंगे। अगर आप full-archive पोस्ट काउंट endpoint का इस्तेमाल करना चाहते हैं, या advanced operators और लंबी query length का उपयोग करना चाहते हैं, तो आपको enterprise access के लिए स्वीकृत होना होगा।
ज़्यादा जानने के लिए कृपया enterprise access पर हमारे सेक्शन पर जाएँ।
हर दिन, हज़ारों डेवलपर X API को अनुरोध भेजते हैं। इस मात्रा को प्रबंधित करने में मदद के लिए, प्रत्येक एंडपॉइंट पर रेट लिमिट्स लागू की जाती हैं, जो उन अनुरोधों की संख्या सीमित करती हैं जिन्हें हर डेवलपर किसी ऐप या किसी प्रमाणित उपयोगकर्ता की ओर से कर सकता है।
यह एंडपॉइंट ऐप-स्तर पर रेट लिमिटेड है। इसका मतलब है कि आप, एक डेवलपर के रूप में, किसी भी दिए गए ऐप से (जिसका निर्धारण आपके द्वारा उपयोग किए जा रहे credentials के आधार पर होता है) एक निश्चित समयावधि में इस एंडपॉइंट पर केवल एक निश्चित संख्या में अनुरोध कर सकते हैं।
इन endpoints की मुख्य विशेषता यह है कि ये आपके लिए उपलब्ध कराई जाने वाली गणनाओं में पोस्ट्स को फ़िल्टर करने के लिए एक ही query का उपयोग करते हैं। ये queries operators से मिलकर बनती हैं, जो पोस्ट और उपयोगकर्ता विशेषताओं, जैसे message keywords, hashtags, और URLs, के आधार पर मिलान करते हैं। query के मिलान व्यवहार को और अधिक सटीक बनाने के लिए operators को boolean logic और parentheses के साथ जोड़कर queries बनाई जा सकती हैं।
अधिक जानने के लिए, query कैसे बनाएं पर हमारी मार्गदर्शिका देखें।
हाल के पोस्ट काउंट के लिए, कोई next_token वापस नहीं मिलता है। इसका मतलब है कि ग्रैन्युलैरिटी चाहे जो भी हो, आपको पिछले 7 दिनों का पोस्ट वॉल्यूम एक ही API कॉल में मिल जाएगा।
फ़ुल-आर्काइव पोस्ट काउंट के लिए, आपको पिछले 30 दिनों का डेटा मिलेगा। 30 दिनों से अधिक पुराने डेटा के लिए, आपको एक next_token मिलेगा, जिसका उपयोग करके आप अतिरिक्त डेटा पाने के लिए पेजिनेट कर सकते हैं।