Jump to content

विकिमीडिया REST API

From mediawiki.org
This page is a translated version of the page Wikimedia REST API and the translation is 100% complete.

विकिमीडिया REST API से मशीन-पठनीय प्रारूपों में विकिमीडिया की सामग्री और मेटाडेटा को प्राप्त किया जा सकता है। यह उच्च-मात्रा में उपयोग के मामलों पर केंद्रित है, इसलिए यह विकिमीडिया की ग्लोबल रूप से वितरित कैशिंग अर्थव्यवस्था से एकीकृत है। इस वजह से API के उपयोगकर्ताओं को लेटेंसी का अनुभव कम होता है और अनुरोधों की उच्च मात्रा का समर्थन मिलता है।

सभी मुख्य विकिमीडिया परियोजनाओं के लिए /api/rest_v1/ पर REST API और उसका प्रलेख उपलब्ध है। उदाहरणस्वरूप, अंग्रेज़ी विकिपीडिया के लिए यह https://en.wikipedia.org/api/rest_v1/ पर उपलब्ध है।

हालाँकि ज़्यादातर विकियों द्वारा दी जाने वाली कार्यक्षमता अंग्रेज़ी विकिपीडिया की कार्यक्षमता से मेल खाती है, कई अपवाद देखे जा सकते हैं:

  • wikimedia.org पृष्ठ के देखे जाने के मेट्रिक्स जैसी क्रॉस-परियोजना जानकारी प्रदान करता है।
  • en.wiktionary.org एक प्रयोगात्मक परिभाषा और पॉइंट प्रदान करता है, जो विकिकोश की जानकारी को संरचित डेटा के रूप में प्रदर्शित करता है। दूसरी भाषाओं के लिए समर्थन पर चर्चा चल रही है

संस्करण

REST API इस संस्करण नीति का पालन करती है।

नियम और शर्तें

  • REST API का इस्तेमाल करके आप विकिमीडिया की साधारण उपयोग की शर्तों और गोपनीयता नीति को स्वीकार करते हैं।
  • API के दूसरे उपयोगकर्ताओं पर ज़्यादा प्रभाव न डालने के लिए अपने क्लाइंट्स को इस API पर 200 अनुरोध प्रति सेकंड पर सीमित करें। कई एंट्री पॉइंट्स और भी सीमित रेट सीमाएँ लागू करते हैं।
  • एक अनूठा User-Agent या Api-User-Agent हैडर सेट करें ताकि हम आपसे जल्दी संपर्क कर पाएँ। संपर्क पृष्ठों के ईमेल पते या URL भी काम आते हैं।

दूसरे API

मीडियाविकि 1.35 और उसके बाद से उपलब्ध REST API के लिए मीडियाविकि मूल REST API देखें।

यह टेबल: देखें · वार्ता · सम्पादन
API उपलब्धता URL आधार उदाहरण
मीडियाविकि प्रतिक्रिया API मीडियाविकि में शामिल

विकिमीडिया परियोजनाओं पर सक्षम

/api.php https://hi.wikipedia.org/w/api.php?action=query&prop=info&titles=पृथ्वी
मीडियाविकि REST API मीडियाविकि 1.35 से अधिक में शामिल

विकिमीडिया परियोजनाओं पर सक्षम

/rest.php https://hi.wikipedia.org/w/rest.php/v1/page/पृथ्वी
विकिमीडिया REST API मीडियाविकि में शामिल नहीं

सिर्फ विकिमीडिया परियोजनाओं के लिए उपलब्ध

/api/rest https://hi.wikipedia.org/api/rest_v1/page/title/पृथ्वी
विकिमीडिया परियोजनाओं के लिए वाणिज्यिक-आकार API-ओं के लिए Wikimedia Enterprise देखें।

ये भी देखें

  • RESTBase, REST API के पीछे की प्रौद्योगिकी जिसे पदावनत कर दिया जा रहा है
  • 1.0 प्रकाशन की घोषणा वाला ब्लॉग पोस्ट। उत्पाद में कई ज़रूरी उपयोग के मामलों का वर्णन करता है, इस बारे में चर्चा करता है कि REST API किस तरह से विकिमीडिया की विशाल तकनीकी रणनीति के अनुकूल है, और कार्यान्वयन से जुड़ी कुछ टिप्पणियाँ प्रदान करता है।
  • API को Node.js की मदद से लागू किया जाता है। इस ब्लॉग पोस्ट में REST API और दूसरी सेवाओं को Node 6 पर अपग्रेड करने के दौरान हमारे अनुभव का वर्णन किया गया है।
  • मीडियाविकि मंच दल, REST API के लिए उत्पाद के मालिक।
  • Core Platform Team/Initiatives/API Gateway (2020)