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

उपयोगी टूल

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

Postman

Postman एक बेहतरीन टूल है, जिसका इस्तेमाल आप किसी एंडपॉइंट को टेस्ट करने के लिए कर सकते हैं। हर Postman अनुरोध में सभी path और body parameters शामिल होते हैं, ताकि आप जल्दी से समझ सकें कि आपके लिए क्या उपलब्ध है। हमारी 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 का उपयोग करना कठिन हो सकता है। यदि आप इस प्रमाणीकरण विधि से परिचित नहीं हैं, तो हम अनुशंसा करते हैं कि आप library का उपयोग करें, Postman जैसे किसी टूल का इस्तेमाल करें, या अपने अनुरोधों को प्रमाणित करने के लिए OAuth 2.0 का उपयोग करें। OAuth 2.0 Authorization Code with PKCE किसी application के scope पर अधिक नियंत्रण और कई डिवाइसों पर authorization flow की सुविधा देता है। OAuth 2.0 आपको विशिष्ट, सूक्ष्म scopes चुनने देता है, जो किसी उपयोगकर्ता की ओर से आपको खास permissions प्रदान करते हैं। अपने ऐप में OAuth 2.0 सक्षम करने के लिए, आपको डेवलपर कंसोल के App settings section में मौजूद अपने App की authentication settings में इसे सक्षम करना होगा।

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

प्रमाणीकरण क्रेडेंशियल्स का ऐसा सेट प्राप्त करने के लिए, जो X API v2 एंडपॉइंट्स के साथ काम करे, आपके पास एक [डेवलपर खाता]/resources/fundamentals/developer-portal) होना चाहिए, उस खाते के भीतर एक प्रोजेक्ट सेट अप होना चाहिए, और उस प्रोजेक्ट के भीतर एक डेवलपर ऐप बनाया गया होना चाहिए। इसके बाद, आप अपने डेवलपर ऐप के भीतर अपनी कीज़ और टोकन पा सकते हैं।

रेट लिमिट्स

हर दिन, हज़ारों डेवलपर X API को अनुरोध भेजते हैं। इन अनुरोधों की बड़ी मात्रा को प्रबंधित करने में मदद के लिए, प्रत्येक एंडपॉइंट पर रेट लिमिट्स लागू की जाती हैं, जो उन अनुरोधों की संख्या को सीमित करती हैं जिन्हें आप अपने ऐप की ओर से या किसी प्रमाणीकृत उपयोगकर्ता की ओर से भेज सकते हैं। इन एंडपॉइंट्स पर उपयोगकर्ता-स्तर की रेट लिमिट लागू होती है। इसका मतलब है कि जिस प्रमाणीकृत उपयोगकर्ता की ओर से आप अनुरोध कर रहे हैं, वह किसी भी डेवलपर ऐप में इस एंडपॉइंट को केवल सीमित संख्या में ही कॉल कर सकता है। POST method के लिए उपयोगकर्ता रेट लिमिट 15 मिनट में 200 अनुरोध है। DELETE method की रेट लिमिट 15 मिनट में 50 अनुरोध है। इसके अलावा, 3 घंटे में 300 अनुरोध की भी सीमा है, जिसमें manage पोस्ट्स या manage Retweets के ज़रिए बनाई गई पोस्ट्स भी शामिल हैं।

स्रोत लेबल

आपके ऐप का नाम और वेबसाइट URL, आपके एप्लिकेशन द्वारा प्रोग्रामेटिक रूप से बनाई गई किसी भी पोस्ट के मेटाडेटा में स्रोत लेबल के रूप में दिखाई देंगे। यदि आप किसी X ऐप का यूज़ केस बदलते हैं, तो Developer Terms के अनुपालन को सुनिश्चित करने के लिए इन सेटिंग्स में उसे भी अवश्य अपडेट करें।

प्रोफ़ाइल सेटिंग्स

आप पोस्ट्स में स्थान केवल तभी जोड़ सकते हैं, जब आपकी प्रोफ़ाइल सेटिंग्स में geo सक्षम हो। यदि geo सक्षम नहीं है, तब भी आप अपने अनुरोध बॉडी में location पैरामीटर जोड़ सकते हैं, लेकिन वह आपकी पोस्ट्स से संलग्न नहीं होगा। यही बात इमेज में उपयोगकर्ताओं को टैग करने पर भी लागू होती है। यदि जिस उपयोगकर्ता को आप टैग कर रहे हैं, उसके लिए photo-tagging सक्षम नहीं है, तो पोस्ट सफलतापूर्वक बन जाने पर भी उसका नाम टैग किए गए उपयोगकर्ताओं की सूची में दिखाई नहीं देगा।

किसी पोस्ट में मीडिया जोड़ना

फ़िलहाल, X API के v2 का उपयोग करके मीडिया को पूरी तरह अपलोड करने का कोई तरीका नहीं है। हालांकि, आप पहले से अपलोड किए गए मीडिया को किसी पोस्ट के साथ संलग्न कर सकते हैं। आप उन मीडिया id का उपयोग कर सकते हैं जिन्हें पहले v1 media एंडपॉइंट या X Media Studio का उपयोग करके अपलोड किया गया है। ये मीडिया id आपके अपने होने चाहिए या किसी प्रमाणीकृत उपयोगकर्ता के होने चाहिए।

कोड उदाहरण

एक पोस्ट बनाएँ

cURL
curl -X POST "https://api.x.com/2/tweets" \
  -H "Authorization: OAuth ..." \
  -H "Content-Type: application/json" \
  -d '{"text": "Hello world!"}'

जवाब बनाएँ

cURL
curl -X POST "https://api.x.com/2/tweets" \
  -H "Authorization: OAuth ..." \
  -H "Content-Type: application/json" \
  -d '{"text": "This is a reply!", "reply": {"in_reply_to_tweet_id": "1234567890"}}'

कोई पोस्ट हटाएँ

cURL
curl -X DELETE "https://api.x.com/2/tweets/1234567890" \
  -H "Authorization: OAuth ..."
अगले चरण API संदर्भ