 | এই পাতাটিমিডিয়াউইকি action API নথির অংশ। |
| MediaWiki Action API |
|---|
| Basics |
| Authentication |
| Accounts and Users |
| Page Operations |
|
| অনুসন্ধান |
| Developer Utilities |
| Tutorials |
| দে · আ · স |
এই টিউটোরিয়ালে, আপনিMediaWiki Action API সম্পর্কে শিখবেন, এটি কীভাবে ব্যবহার করবেন, অনুরোধ বিন্যাস, একটি সাধারণ প্রশ্ন, এবং Action API ব্যবহার করে প্রজেক্টের উদাহরণ।
মিডিয়াউইকি Action API হল একটিRESTপূর্ণ যা ব্যবহারকারীদের কিছু উইকি-ক্রিয়া সম্পাদন করতে দেয় যেমন পৃষ্ঠা তৈরি, প্রমাণীকরণ, পার্সিং, অনুসন্ধান, ইত্যাদিAPI বোঝার জন্যAPI:Main page একটি ভাল সূচনা পয়েন্ট।
আপনার প্রোগ্রাম উইকি বৈশিষ্ট্যগুলিতে অ্যাক্সেস পেতে API-কে অনুরোধ পাঠায়।উদাহরণস্বরূপ, একটি উইকিতে লগ ইন করুন, একটি পৃষ্ঠা তৈরি করুন এবং সম্পাদনা করুন, একটি শিরোনাম অনুসন্ধান করুন, বিষয়বস্তু পাঠ্য অনুসন্ধান করুন বা বিষয়বস্তু পার্স করুন।Action API তৃতীয় পক্ষের বিকাশকারী, উইকিমিডিয়া এক্সটেনশন বিকাশকারী এবং উইকি সাইট প্রশাসকদের জন্য উপলব্ধ।
এই পৃষ্ঠার ডান সাইডবারে, বিভাগ দ্বারা গোষ্ঠীবদ্ধ, API দ্বারা সমর্থিত অনেক বৈশিষ্ট্য রয়েছে।উইকি সার্ভারে অনুরোধ পাঠানোর আগে, প্রথমেডেটা ফরম্যাট,ত্রুটি এবং সতর্কতা, এবংAction API FAQ-এর মতো ওভারভিউ পৃষ্ঠাগুলি পড়ুন।
আপনি -র মাধ্যমে ক্লায়েন্ট সাইড থেকে সার্ভারে ডেটার জন্য অনুরোধ করতে পারেন এবং একটি আদর্শ বিন্যাসে (সাধারণত ) প্রতিক্রিয়া পেতে পারেন।একটি অনুরোধ একটি শেষ পয়েন্ট এবং পরামিতিগুলির একটি সেট নিয়ে গঠিত।দুই ধরনের অনুরোধ করা যেতে পারে:GET এবংPOST।একটি GET অনুরোধের জন্য, একটি প্যারামিটারে URL-এ একটি ক্যোয়ারী স্ট্রিং থাকবে।একটি POST অনুরোধের জন্য, প্যারামিটারগুলিকে বিন্যাসে বিন্যাস করুন।
সমস্ত উইকিমিডিয়া উইকির এই বিন্যাসেhttp://example.org/w/api.php এন্ডপয়েন্ট রয়েছে। মিডিয়াউইকি প্রধান সাইট বা ইংরেজি উইকিপিডিয়ায় কাজ করতে, সংশ্লিষ্ট এন্ডপয়েন্ট ব্যবহার করুন। উদাহরণ স্বরূপ, ইংরেজি উইকিপিডিয়ার মূল্য $2 হল নতুন অ্যাকাউন্ট পরীক্ষা করার জন্য বা পৃষ্ঠাগুলিতে সম্পাদনা পরীক্ষা করার জন্য, পরীক্ষা উইকি এন্ডপয়েন্ট $3 ব্যবহার করুন।To operate on the MediaWiki main site or English Wikipedia, use the related endpoint.For example, the English Wikipedia is athttps://en.wikipedia.org/w/api.php.For testing new accounts or test edits to pages, use the test wiki endpointhttps://test.wikipedia.org/w/api.php.
URL-এর ক্যোয়ারী স্ট্রিং-এaction প্যারামিটার যোগ করুন। এটি API কে বলে যে কোন ক্রিয়াটি সম্পাদন করতে হবে। সবচেয়ে জনপ্রিয় অ্যাকশন হল $2 (ইউআরএলে $3 থাকবে, যা উইকি থেকে ডেটা আনার অনুমতি দেয়। $4 প্যারামিটার অনুসরণ করে, আপনি তিনটি ক্যোয়ারী মডিউল প্রকারের মধ্যে কোনটি সম্পাদন করতে চান তা নির্দেশ করতে অন্য প্যারামিটার যোগ করুন:It tells the API which action to perform.The most popular action isquery (the URL would containaction=query), which allows fetching data from a wiki.Following theaction parameter, add another parameter to indicate which one of the three query module types you want to perform:
prop - পৃষ্ঠাগুলির বৈশিষ্ট্য পান list - একটি নির্দিষ্ট মানদণ্ডের সাথে মিলে যাওয়া পৃষ্ঠাগুলির তালিকা পানmeta - উইকি এবং ব্যবহারকারী সম্পর্কে মেটা তথ্য পানঅবশেষে,format প্যারামিটার অন্তর্ভুক্ত করুন, যা API-কে বলে যে কোন ফর্ম্যাটে ফলাফল পেতে হবে। প্রস্তাবিত বিন্যাস হল JSON। এপিআইঅতীতে অন্যান্য আউটপুট ফরম্যাট সমর্থিত, কিন্তু সেগুলি সাধারণত সুপারিশ করা হয় না।The recommended format is JSON.The API hassupported other output formats in the past, but they are not generally recommended.
Action API-এর প্রসঙ্গে একটি সাধারণ GET অনুরোধ এবং প্রতিক্রিয়া কেমন হবে তা বোঝার জন্য একটি সাধারণ প্রশ্নের উদাহরণ নেওয়া যাক।
আসুন উইকিতে একটি শিরোনাম অনুসন্ধান করি। আমরাAPI:অনুসন্ধান-এ নথিভুক্তsearch মডিউল ব্যবহার করব।
পৃষ্ঠার শিরোনাম বাCraig Noone-এর সাথে মেলে এমন সামগ্রী অনুসন্ধান করতে, HTTP GET অনুরোধের URLটি হবে:
URL-এর প্রতিটি অংশের ব্যাখ্যা:
http://en.wikipedia.org/w/api.php হল মূল শেষ পয়েন্ট। এই ক্ষেত্রে এটি ইংরেজি উইকিপিডিয়া।action=query মানে উইকি থেকে ডেটা আনা।list=search মানে একটি মানদণ্ডের সাথে মিলে যাওয়া পৃষ্ঠাগুলির তালিকা পান৷srsearch=Craig%20Noone পৃষ্ঠার শিরোনাম বা বিষয়বস্তু অনুসন্ধান করতে নির্দেশ করে।%20 একটি URL-এ একটি স্পেস অক্ষর নির্দেশ করে।format=json JSON আউটপুট নির্দেশ করে, যা প্রস্তাবিত আউটপুট বিন্যাস।প্রতিক্রিয়া হল একটি JSON ফরম্যাট নথি যার সাথে পৃষ্ঠার শিরোনামগুলির একটি তালিকা যাCraig Noone-এর সাথে মেলে:
{"batchcomplete":"","continue":{"sroffset":10,"continue":"-||"},"query":{"searchinfo":{"totalhits":210},"search":[{"ns":0,"title":"Craig Noone","pageid":18846922,"size":22548,"wordcount":1771,"snippet":"<span class=\"searchmatch\">Craig</span> Stephen <span class=\"searchmatch\">Noone</span> (born 17 November 1987) is an English professional footballer who plays as a winger for Bolton Wanderers. Born in Kirkby, he has also","timestamp":"2018-11-02T22:25:45Z"},{"ns":0,"title":"Noone","pageid":32906333,"size":553,"wordcount":64,"snippet":"<span class=\"searchmatch\">Noone</span> is a surname that may refer to: <span class=\"searchmatch\">Craig</span> <span class=\"searchmatch\">Noone</span> (born 1987), English football midfielder Jimmie <span class=\"searchmatch\">Noone</span> (1895–1944), American jazz clarinetist Kathleen","timestamp":"2015-08-16T05:16:17Z"}...]}}
উইকিমিডিয়ার কিছু প্রকল্পের উদাহরণ যা Action API ব্যবহার করে:
