MediaWiki API दस्तावेज़: Difference between revisions

Latest revision as of 05:04, 7 May 2025

__मीडियाविकि एपीआई दस्तावेज़: शुरुआती के लिए एक विस्तृत गाइड__

मीडियाविकि एपीआई (एप्लीकेशन प्रोग्रामिंग इंटरफेस) एक शक्तिशाली उपकरण है जो डेवलपर्स को प्रोग्रामेटिक रूप से मीडियाविकि विकियों के साथ इंटरैक्ट करने की अनुमति देता है। यह आपको स्वचालित रूप से डेटा प्राप्त करने, विकि सामग्री को अपडेट करने और कस्टम एप्लिकेशन बनाने में सक्षम बनाता है। यह लेख शुरुआती लोगों के लिए एक व्यापक गाइड है, जो मीडियाविकि एपीआई की मूल अवधारणाओं, प्रमाणीकरण विधियों, उपलब्ध कार्यों और सामान्य उपयोग के मामलों को कवर करेगा।

मीडियाविकि एपीआई क्या है?

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

यह विभिन्न प्रकार के कार्यों के लिए उपयोगी है, जिनमें शामिल हैं:

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

एपीआई तक पहुंचना

मीडियाविकि एपीआई आमतौर पर HTTP GET या POST अनुरोधों के माध्यम से एक्सेस किया जाता है। एपीआई एंडपॉइंट आमतौर पर आपके विकि के URL के बाद "/api.php" होता है। उदाहरण के लिए, यदि आपका विकि "https://example.com/wiki/" पर होस्ट किया गया है, तो एपीआई एंडपॉइंट "https://example.com/wiki/api.php" होगा।

एपीआई अनुरोधों को विभिन्न मापदंडों के साथ भेजा जा सकता है जो निर्दिष्ट करते हैं कि आप कौन सा कार्य करना चाहते हैं और कौन सा डेटा प्राप्त करना चाहते हैं। इन मापदंडों को URL में (GET अनुरोधों के लिए) या अनुरोध बॉडी में (POST अनुरोधों के लिए) पारित किया जा सकता है।

प्रमाणीकरण

मीडियाविकि एपीआई तक पहुंचने के लिए प्रमाणीकरण आवश्यक हो सकता है, खासकर उन कार्यों के लिए जो विकि सामग्री को संशोधित करते हैं। प्रमाणीकरण के लिए कई तरीके उपलब्ध हैं:

यूजर और पासवर्ड: यह सबसे सरल तरीका है, लेकिन यह सुरक्षित नहीं है।
कुकियों: यदि आपके पास पहले से ही विकि में एक वैध सत्र है, तो आप कुकीज़ का उपयोग करके प्रमाणित हो सकते हैं।
OAuth: यह प्रमाणीकरण का सबसे सुरक्षित तरीका है। यह आपको विकि तक पहुंच प्रदान करने के लिए उपयोगकर्ता को अनुमति देने की अनुमति देता है, बिना उन्हें अपना पासवर्ड साझा किए। OAuth 2.0 सुरक्षा के लिए महत्वपूर्ण है।
API टोकन: यह एक विशेष टोकन है जो आपको एपीआई तक पहुंच प्रदान करता है। इसे विशेष:एपि टोकन पृष्ठ से प्राप्त किया जा सकता है।

एपीआई क्रियाएं (Actions)

मीडियाविकि एपीआई विभिन्न प्रकार की क्रियाएं प्रदान करता है जो आपको विभिन्न कार्य करने की अनुमति देती हैं। कुछ सबसे आम क्रियाओं में शामिल हैं:

मीडियाविकि एपीआई क्रियाएं
! क्रिया	! विवरण	! उदाहरण
query	विकि से डेटा प्राप्त करें।	`action=query&titles=Main%20Page&prop=revisions`
edit	विकि पृष्ठ को संपादित करें।	`action=edit&title=Main%20Page&text=यह एक नया पाठ है।`
create	एक नया विकि पृष्ठ बनाएं।	`action=create&title=New%20Page&text=यह एक नया पृष्ठ है।`
delete	विकि पृष्ठ को हटाएं।	`action=delete&title=Page%20to%20Delete`
upload	एक फ़ाइल अपलोड करें।	`action=upload&filename=example.jpg`
login	विकि में लॉग इन करें।	`action=login&username=username&password=password`
logout	विकि से लॉग आउट करें।	`action=logout`
categories	पृष्ठों की श्रेणियों की सूची प्राप्त करें	`action=categories&title=Main%20Page`

यह केवल कुछ उदाहरण हैं। मीडियाविकि एपीआई बहुत अधिक क्रियाएं प्रदान करता है। आप विशेष:एपीआई सैंडबॉक्स में विभिन्न क्रियाओं के साथ प्रयोग कर सकते हैं।

डेटा प्रारूप

मीडियाविकि एपीआई विभिन्न डेटा प्रारूपों में डेटा लौटा सकता है, जिसमें शामिल हैं:

JSON: यह सबसे आम डेटा प्रारूप है। यह मानव-पठनीय है और आसानी से पार्स किया जा सकता है।
XML: यह एक और सामान्य डेटा प्रारूप है।
PHP: यह डेटा प्रारूप PHP अनुप्रयोगों के लिए उपयुक्त है।

डेटा प्रारूप को `format` पैरामीटर का उपयोग करके निर्दिष्ट किया जा सकता है। उदाहरण के लिए, `format=json` JSON प्रारूप में डेटा लौटाएगा।

सामान्य उपयोग के मामले

मीडियाविकि एपीआई का उपयोग विभिन्न प्रकार के कार्यों के लिए किया जा सकता है। यहां कुछ सामान्य उपयोग के मामले दिए गए हैं:

ऑटो-सारांश: एपीआई का उपयोग करके, आप किसी लेख की सामग्री का स्वचालित रूप से सारांश उत्पन्न कर सकते हैं।
लिंक चेकिंग: एपीआई का उपयोग करके, आप विकि में टूटे हुए लिंक की पहचान कर सकते हैं।
विकि सामग्री का बैकअप: एपीआई का उपयोग करके, आप विकि सामग्री का नियमित रूप से बैकअप ले सकते हैं।
अन्य अनुप्रयोगों के साथ विकि डेटा का एकीकरण: एपीआई का उपयोग करके, आप विकि डेटा को अन्य अनुप्रयोगों, जैसे कि CRM सिस्टम या डेटा विश्लेषण उपकरण के साथ एकीकृत कर सकते हैं।
कस्टम खोज: विकि के अंतर्निहित खोज फ़ंक्शन से परे, अधिक जटिल खोजों को करने के लिए एपीआई का उपयोग करें।

उन्नत अवधारणाएं

मॉड्यूल: आप मीडियाविकि में मॉड्यूल बनाकर एपीआई के साथ अपने स्वयं के कस्टम क्रियाएं और डेटा प्रारूप जोड़ सकते हैं।
फ़िल्टर: एपीआई अनुरोधों में फ़िल्टर का उपयोग करके, आप लौटाए गए डेटा को सीमित कर सकते हैं।
सीमा: एपीआई अनुरोधों में सीमा का उपयोग करके, आप लौटाए गए परिणामों की संख्या को सीमित कर सकते हैं।
निरंतरता: बड़ी मात्रा में डेटा प्राप्त करते समय, आपको परिणामों को पृष्ठों में प्राप्त करने के लिए निरंतरता का उपयोग करने की आवश्यकता हो सकती है।

त्रुटि प्रबंधन

मीडियाविकि एपीआई त्रुटियों को दर्शाने के लिए त्रुटि कोड और संदेश लौटाता है। त्रुटि कोड एक संख्यात्मक मान होता है जो त्रुटि के प्रकार को इंगित करता है। त्रुटि संदेश त्रुटि के बारे में अधिक जानकारी प्रदान करता है।

त्रुटियों को संभालने के लिए, आपको एपीआई प्रतिक्रिया में त्रुटि कोड और संदेश की जांच करनी चाहिए। यदि कोई त्रुटि होती है, तो आपको उचित कार्रवाई करनी चाहिए, जैसे कि उपयोगकर्ता को एक त्रुटि संदेश प्रदर्शित करना या त्रुटि को लॉग करना।

सुरक्षा सावधानियां

मीडियाविकि एपीआई का उपयोग करते समय, निम्नलिखित सुरक्षा सावधानिया

अभी ट्रेडिंग शुरू करें

IQ Option पर रजिस्टर करें (न्यूनतम जमा $10) Pocket Option में खाता खोलें (न्यूनतम जमा $5)

हमारे समुदाय में शामिल हों

हमारे Telegram चैनल @strategybin से जुड़ें और प्राप्त करें: ✓ दैनिक ट्रेडिंग सिग्नल ✓ विशेष रणनीति विश्लेषण ✓ बाजार की प्रवृत्ति पर अलर्ट ✓ शुरुआती के लिए शिक्षण सामग्री