मुख्य सामग्री पर जाएं
इस पेज में कई टूल्स और महत्वपूर्ण अवधारणाओं के बारे में जानकारी दी गई है, जिन्हें अपने सिस्टम में manage Bookmarks endpoints को इंटिग्रेट करते समय आपको जानना चाहिए। हमने इस पेज को कुछ अलग-अलग सेक्शनों में विभाजित किया है:

​
उपयोगी टूल

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

​
Postman

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

​
कोड नमूने

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

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

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

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

​
प्रमाणीकरण

सभी X API v2 endpoint्स के लिए आपको अपने अनुरोधों को क्रेडेंशियल्स के एक सेट से प्रमाणित करना होगा, जिन्हें keys और tokens भी कहा जाता है। इन विशिष्ट endpoint्स के लिए OAuth 2.0 Authorization Code Flow with PKCE का उपयोग करना आवश्यक है। इसका मतलब है कि सफल अनुरोध करने के लिए आपको keys और उपयोगकर्ता Access Tokens के एक सेट का इस्तेमाल करना होगा। Access Tokens उस उपयोगकर्ता से संबद्ध होने चाहिए, जिसकी ओर से आप अनुरोध कर रहे हैं। अगर आप किसी दूसरे उपयोगकर्ता के लिए Access Tokens का एक सेट जनरेट करना चाहते हैं, तो उन्हें Authorize URL का उपयोग करके आपके ऐप को अधिकृत करना होगा या स्वयं प्रमाणीकरण करना होगा। कृपया ध्यान दें कि OAuth 2.0 का उपयोग करना थोड़ा जटिल हो सकता है। अगर आप इस प्रमाणीकरण विधि से परिचित नहीं हैं, तो हम सुझाव देते हैं कि अपने अनुरोधों को सही तरीके से प्रमाणित करने के लिए आप किसी लाइब्रेरी या Postman जैसे टूल का उपयोग करें।

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

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

​
रेट लिमिट्स

हर दिन, हज़ारों डेवलपर X API को अनुरोध भेजते हैं। इन अनुरोधों की बहुत बड़ी संख्या को प्रबंधित करने में मदद के लिए, प्रत्येक endpoint पर रेट लिमिट्स लागू की जाती हैं, जो उन अनुरोधों की संख्या सीमित करती हैं जिन्हें आप अपने ऐप की ओर से या किसी प्रमाणित उपयोगकर्ता की ओर से कर सकते हैं। इन endpoints पर उपयोगकर्ता-स्तर की रेट लिमिट्स लागू होती हैं। इसका मतलब है कि जिस प्रमाणित उपयोगकर्ता की ओर से आप अनुरोध कर रहे हैं, वह किसी भी डेवलपर ऐप में इस endpoint को केवल एक निश्चित संख्या में ही कॉल कर सकता है। GET method के लिए 15 मिनट की विंडो में 180 अनुरोधों की उपयोगकर्ता रेट लिमिट है। Bookmarks lookup endpoint के GET method का उपयोग करने पर, आपको अपनी सबसे हाल की 800 Bookmarked पोस्ट्स वापस मिलेंगी। इसके अलावा, POST और DELETE methods के लिए 15 मिनट में 50 अनुरोधों की उपयोगकर्ता रेट लिमिट है।

​
कोड उदाहरण

​
बुकमार्क प्राप्त करें

cURL
curl "https://api.x.com/2/users/123/bookmarks?tweet.fields=created_at,public_metrics" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

​
बुकमार्क बनाएँ

cURL
curl -X POST "https://api.x.com/2/users/123/bookmarks" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"tweet_id": "1234567890"}'