API:FAQ

From mediawiki.org

This page is a translated version of the page API:FAQ and the translation is 84% complete.

मीडियाविकि क्रिया API
बुनियाद
शिष्टाचार और उपयोग के दिशानिर्देश सभी क्वेरी मॉड्यूल्स सभी पृष्ठ गुणधर्म सभी सूची मॉड्यूल्स सभी मेटा मॉड्यूल्स आउटपुट के प्रारूप
प्रमाणीकरण
डेटा संशोधन कार्यों के लिए टोकन पाएँ Login Logout प्रमाणीकरण सत्यापन (अभिकथन)
खाते और सदस्य
खाता बनाएँ सदस्य को अवरोधित या अनावरोधित करें वर्तमान सदस्य के बारे में जानकारी पाएँ वर्तमान सदस्य की ध्यानसूची को फ़ीड के रूप में पाएँ सदस्य विकल्प बदलें सदस्य की समूहों में सदस्यता को बदलें ईमेल भेजें
पृष्ठ कार्य
पृष्ठ बनाएँ और सम्पादित करें Get the contents of a page फ़ाइल अपलोड करें पृष्ठ आयात करें पृष्ठ हटाएँ पृष्ठ की सामग्री पार्स करें पृष्ठ पर ध्यान रखें या ध्यान हटाएँ पृष्ठ का कैश साफ करें पृष्ठ को रोलबैक करें पृष्ठ स्थानांतरित करें पृष्ठ या अवतरण परीक्षित करें हटाए गए पृष्ठ के अवतरण पुनर्स्थापित करें पृष्ठ का सुरक्षा स्तर बदलें पृष्ठ की भाषा बदलें और भी...
खोजें
शीर्षक के अनुसार विकि पृष्ठ खोजें (OpenSearch) शीर्षक या टेक्स्ट के अनुसार विकि पृष्ठों के लिए उन्नत खोज किसी जगह के आस-पास विकि पृष्ठ खोजें भाषा का नाम खोजें पृष्ठों के नामों में कोई विशिष्ट उपसर्ग खोजें
विकासक उपकरण
लाइब्रेरियाँ पाएँ Cross-site requests एक्सटेंशन में API मॉड्यूल बनाना मीडियाविकि और एक्सटेंशनों में API का इस्तेमाल करना API के उपयोग को सीमित करना Localisation Implementation Strategy
ट्यूटोरियल्स
क्रिया API ट्यूटोरियल Article ideas generator Nearby places viewer Picture of the day viewer Holidays viewer
दे · वा · स

इस पृष्ठ पर मीडियाविकि प्रतिक्रिया API के बारे में कुछ अक्सर पूछे जाने वाले प्रश्नों के उत्तर मौजूद हैं। This page is intended for technical contributors and software developers who wish to understand and use the MediaWiki Action API.

API:Main page भी पढ़ें। यह कुछ अनुत्तरित सवालों के जवाब और दूसरे उपयोगी पृष्ठों की ओर इशारा करता है।

API ऐप्लिकेशन प्रोग्रामिंग इंटरफ़ेस का एक संक्षिप्त रूप है। इससे अलग-अलग ऐप्लिकेशन्स एक-दूसरे से संपर्क कर सकते हैं। Sometimes an API allows an application to request an action to be done by the application which implements the API. मीडियाविकि के शब्दों में, यह वेब-आधारित API-ओं को दर्शाता है, जो HTTP अनुरोध-उत्तर तंत्र का इस्तेमाल करके JSON/XML संरचित डेटा का निर्माण करते हैं।

REST, REpresentational State Transfer का एक संक्षिप्त रूप है। एक RESTful प्रणाली को कुछ सिद्धांतों और बाधाओं के एक समूह द्वारा परिभाषित किया जाता है।

API के कुछ उपयोग देखें।

ये रहे कुछ संसाधन:

• API समझना
• API का परिचय
• w:REST – REST (Representational State Transfer) APIs

मीडियाविकि प्रतिक्रिया API एक RESTful वेब सेवा है जिससे सदस्य पृष्ठ निर्माण, प्रमाणीकरण, पार्सिंग, खोज, आदि जैसे विकि-कार्य कर सकते हैं।

मीडियाविकि प्रतिक्रिया API की मदद से:

• विकि की सुविधाओं तक पहुँचा जा सकता है।
• विकि पर कार्य किए जा सकते हैं।
• विकियों और सार्वजनिक सदस्यों के बारे में मेटा-जानकारी प्राप्त की जा सकती है।

दाएँ साइडबार पर API द्वारा समर्थित कई सुविधाओं की कड़ियाँ हैं। और कुछ विकिमीडिया परियोजनाएँ देखें जो मीडियाविकि प्रतिक्रिया API का इस्तेमाल करते हैं।

आम तौर पर HTTP अनुरोधों की मदद से प्रतिक्रिया API को कॉल किया जाता है। विस्तृत विधि के लिए ट्यूटोरियल पढ़ें।

प्रतिक्रिया API के साथ खिलवाड़ के लिए:

• Special:ApiSandbox का इस्तेमाल करें।
• अपने ब्राउज़र का विकासक कंसोल खोजें और विकि पर कार्य करते हुए api.php पर नेट अनुरोधों पर गौर करें।

मीडियाविकि प्रतिक्रिया API में कई मॉड्यूल्स हैं जिनसे हम अलग-अलग कार्य कर सकते हैं। तकनीकी शब्दों में, एक मॉड्यूल ApiBase का एक उपवर्ग है। एक मॉड्यूल में पैरामीटर्स की ज़रूरत होती है। ये पैरामीटर्स सबमॉड्यूल्स हो (और न भी हो) सकते हैं।

यह अनुरोध मानें:

यहाँ:

• action main मुख्य मॉड्यूल का एक पैरामीटर है।
• action=query एक और मॉड्यूल है। इसे क्वेरी मॉड्यूल कहा जाता है। It is called the query module.
• list क्वेरी मॉड्यूल का एक पैरामीटर है।
• list=search भी एक मॉड्यूल है। इसे 2ドル का एक सबमॉड्यूल कहा जा सकता है। It can be called a submodule of action=query.
• srsearch खोज मॉड्यूल का एक पैरामीटर है। इसमें खोज स्ट्रिंग 'abc' है।
• format मुख्य मॉड्यूल का एक पैरामीटर है।
• json आउटपुट का प्रारूप है।

परिचय और दिशानिर्देश भी देखें। इसमें 2ドル मॉड्यूल के सबमॉड्यूल्स को वर्णित किया गया है। It describes the submodules of the action=query module.

मीडियाविकि प्रतिक्रिया API काफ़ी बड़ी है, और एक्सटेंशन्स इसे और भी विस्तृत करते हैं। अपना API अनुरोध गढ़ने के कुछ तरीके हैं:

• साइडबार में वह सुविधा ढूँढ़ें जिसे आप लागू करना चाहते हैं, और कॉल करने के लिए मॉड्यूल्स के बारे में अधिक जानकारी के लिए कड़ी पर क्लिक करें।
• स्वतः प्रलेखित API पृष्ठों संक्षिप्त विवरणों के साथ सभी मॉड्यूल्स और सबमॉड्यूल्स की सूची मौजूद होगी। आप [2ドル मुख्य मॉड्यूल] पर शुरुआत कर सकते हैं और अलग-अलग सबमॉड्यूल्स की कड़ियों पर क्लिक कर सकते हैं। ([4ドル विस्तृत संस्करण] देखने के लिए अंत में 3ドル जोड़ें) You can start at the main module and follow the links to different submodules. (Append recursivesubmodules=1 to view the expanded version)

API प्रलेख पृष्ठों पर एक 'उदाहरण' अनुभाग होता है जिसमें दर्शाया जाता है कि अलग-अलग मॉड्यूल्स और सबमॉड्यूल्स का इस्तेमाल कैसे किया जाता है। [2ドル स्वतः निर्मित प्रलेखों] पर भी मॉड्यूल्स के विवरणों के बाद उदाहरण हैं। The auto-generated docs also have examples trailing the module descriptions.

Python और जावास्क्रिप्ट में कोड कोड स्निपेट्स देखने के लिए Mediawiki-API-demos देखें।

आउटपुट का डिफ़ॉल्ट प्रारूप JSON है। आउटपुट के दूसरे प्रारूपों को नवीनतम स्थिर मीडियाविकि संस्करण में कालग्रस्त कर दिया गया या हटा दिया गया है, और इनके उपयोग को हतोत्साहित किया जाता है।

पुराने संस्करणों पर आउटपुट के प्रारूप को नियंत्रित करने के लिए आप क्वेरी स्ट्रिंग में &format=someformat पास कर सकते हैं।

अधिक जानकारी के लिए API:डेटा प्रारूप देखें।

लॉग-इन करने, सम्पादन, पृष्ठों के स्थानांतरण आदि जैसे डेटा को बदलने वाले कार्यों के लिए आपको एक पहुँच टोकन की ज़रूरत होगी।

अधिक जानकारी के लिए API:Tokens पढ़ें या फिर साइडबार की श्रेणी 'प्रमाणीकरण'।

मीडियाविकि पर क्रॉस-साइट अनुरोध करने के लिए आपको JSONP या CORS का इस्तेमाल करना होगा।

विस्तार के लिए API:क्रॉस-साइट अनुरोध देखें।

हाँ, यह क्वेरी के पैरामीटर पर निर्भर होता है। उदाहरणस्वरूप, list और property के लिए साधारण सदस्यों को अधिकतम 500 परिणाम दिखाए जाएँगे। API पृष्ठों पर 'अतिरिक्त टिप्पणियाँ' या फिर 'सीमाएँ' अनुभाग में इन सीमाओं के बारे में जानकारी होती है। ध्यान रखें कि कुछ मॉड्यूल्स पर विशिष्ट मामलों में सीमाएँ अधिक कठोर हो सकती हैं।

अगर आपको संदेह है कि सीमा को कितना सेट करना चाहिए, और बस अधिकतम संभव परिणाम चाहिए, सीमा को max पर सेट करें।

Since 2026, per-user rate limits have been in place to avoid overloading the infrastructure. कोई ठोस सीमा नहीं है। मगर अवरोध से बचने के लिए हमारी सलाह है आप कॉल्स को उचित सीमा में रखें। अगर आप कई सारे अनुरोध करना चाहते हैं, पहले ही प्रबंधकों से संपर्क कर लें।

API:शिष्टाचार भी देखें।

आप घोषणाएँ और अपडेट्स प्राप्त करने के लिए MediaWiki-API-Announce मेलिंग सूची में सदस्यता ले सकते हैं।

विकिमीडिया के डेटा डम्प्स विकियों संग्रहों, सामग्री, मेटाडेटा, खोज इनडेक्स, आदि के डम्प्स हैं। डम्प्स के साथ काम करने के लिए 'डम्प्स का इस्तेमाल करना' और [3ドル सार्वजनिक डम्प्स] देखें। To work with dumps, see using dumps and public dumps.

अगर आपको मीडियाविकि API प्रलेख या फिर स्वतः निर्मित प्रलेख पृष्ठों पर उत्तर नहीं मिलते, इन साधनों से किसी से संपर्क ज़रूरत करें:

• एक विकिमीडिया खाता बनाएँ (अगर आपके पास पहले से खाता नहीं है) और API चर्चा पृष्ठ पर एक नया विषय जोड़ें।
• अपना सवाल पूछें:
  • #mediawiki ^{जुड़ें} पर IRC चैनल में।
  • MediaWiki-API मेलिंग सूची में

API:एक्सटेंशन पर एक्सटेंशन में API मॉड्यूल बनाने की पूरी प्रक्रिया बताई गई है।

API:Implementation Strategy में मीडियाविकि मूल में API तंत्र के कार्यान्वयन की व्याख्या है।

API के उपयोग को सीमित करने के लिए आप लेखन API के इस्तेमाल को रोक सकते हैं या फिर चुनिंदा मॉड्यूल्स को अक्षम कर सकते हैं।

अनुदेशों और उदाहरणों के लिए 'API:API के उपयोग को सीमित करना' देखें।

अगर आपको कोई त्रुटि आती है, API का त्रुटि संदेश, MediaWiki-API-Error HTTP हैडर सेट कर देगा और एक त्रुटि संरचना लौटाएगा।

अपनी त्रुटि मानक त्रुटि संदेशों की सूची में ढूँढ़कर पता लगाएँ कि त्रुटि का मतलब क्या है।

आप विकिमीडिया के टास्क ट्रैकिंग उपकरण, Phabricator पर बग्स रिपोर्ट कर सकते हैं और सुविधा के अनुरोध फ़ाइल कर सकते हैं।

नोट:

• अपने टास्क पर MediaWiki-API परियोजना टैग जोड़ें।
• अगर आपका रिपोर्ट/अनुरोध किसी एक्सटेंशन द्वारा दिया गया है, उस एक्सटेंशन की परियोजना जोड़ें। (जैसे MediaWiki-extensions-AbuseFilter, MediaWiki-extensions-FlaggedRevs आदि)
• नया टास्क बनाने से पहले नकल ढूँढ़ें।
• आगे बढ़ने से पहले Phabricator पर टास्क के निर्माण की शर्तों को समझें।

अधिक जानकारी के लिए 'किसी बग की शिकायत करें' देखें।

अगर किसी वेबसाइट पर मीडियाविकि का कोई दूसरा संस्करण चल रहा हो, उसमें API का भी कोई दूसरा संस्करण चलेगा। किसी एक संस्करण में समर्थित मॉड्यूल्स पैरामीटर्स को दूसरे संस्करणों में कालग्रस्त कर दिया (या हटा दिया) जा सकता है। अगर इन पैरामीटर्स का इस्तेमाल किया जाता है, ये छूट दिखाएँगे। API पृष्ठों पर ये पदावनतियाँ प्रलेखित की जाती हैं।

API के अलग-अलग संस्करणों के लिए प्रकाशन की टिप्पणियाँ देखें।

Retrieved from "https://www.mediawiki.org/w/index.php?title=API:FAQ/hi&oldid=8553249"

Category:

• MediaWiki action API/hi