MediaWiki API مدد
ایہ MediaWiki Action API دا خودکار طور تے بݨایا ڳیا دستاویزی ورقہ ہے۔
عام معلومات
حالت: MediaWiki API ہک پختہ تے مستحکم انٹرفیس ہے جیندے کوں فعال طور تے سہارا ݙتا ویندا ہے تے بہتر بݨایا ویندا ہے۔ جے اساں ایں کنوں بچݨ دی کوشش کریندے ہیں، اساں کوں کݙاہیں کݙاہیں breaking تبدیلیاں کرݨ دی لوڑ پو سڳدی ہے؛ اپ ڈیٹس دی اطلاع کیتے mediawiki-api-announce میلنگ لسٹ تے سبسکرائب کرو۔ غلط درخواستیں: جڈاں API کوں غلط درخواستیں بھیجیاں ویندیاں ہن، تاں "MediaWiki-API-Error" کلید نال ہک HTTP ہیڈر بھیجیا ویندا ہے تے وت ہیڈر دی قدر تے واپس بھیجے ڳئے غلطی دے کوڈ ݙوہائیں کوں ہکے قدر تے سیٹ کیتا ویندا ہے۔ مزید معلومات کیتے API: غلطیاں تے خبرداریاں ݙیکھو۔
جانچ: API درخواستاں دی جانچ دی آسانی کیتے، Special:ApiSandbox ݙیکھو۔
درخواست دے طریقے
ایکشن API درخواستیں GET تے POST طریقے ورت سڳدیاں ہن۔ GET طریقے کوں ترجیح ݙیو، جیندے نال درخواستاں کوں تیز replica سروراں تے بھیجݨ تے جواباں کوں کیش کرݨ ممکن ہے، جے تائیں پیرامیٹراں آلے URL دی لمبائی ایندی لمبائی دی حد توں ودھ نہ ونڄے (عام طور تے 8000 بائٹس)، یا کوئی ماڈیول صرف POST درخواستیں قبول کریندا ہووے۔ POST درخواستاں دے پیرامیٹر درخواست دے URL دے سوال والے حصے وچ (جیویں GET درخواستاں وچ) تے POST درخواست دے باڈی وچ بھیجے ونڄ سڳدن، تے ہکے درخواست وچ ݙوہائیں طریقیاں کوں رلاوݨ دی اجازت ہے۔ کجھ پیرامیٹر جیویں پاس ورڈ لازمی درخواست دے باڈی وچ بھیجے ونڄن۔ جے ہکا پیرامیٹر URL دے حصے دے طور تے تے درخواست دے باڈی وچ وی بھیجیا ونڄے، تاں ݙوہائیں جاہیں وچ ایندی ہکا قدر ہووݨی چاہیدی ہے۔
ڈیٹا دیاں قسماں
MediaWiki کوں ݙتا ونڄݨ آلا انپٹ NFC-normalized UTF-8 ہووݨا چاہیدا ہے۔ MediaWiki ٻئے انپٹ کوں تبدیل کرݨ دی کوشش کر سڳدا ہے، پر ایں نال کجھ عمل (جیویں MD5 چیکس آلیاں ترمیماں) ناکام تھی سڳدن۔ ہک توں ودھ قدراں آلے پیرامیٹر عام طور تے پائپ اکھر نال قدراں کوں وکھرا کر کے بھیجے ویندن، مثلاً param=value1|value2 یا param=value1%7Cvalue2۔ جے کہیں قدر وچ پائپ اکھر شامل ہووݨا ضروری ہووے، تاں U+001F (Unit Separator) کوں وکھرݨ آلے دے طور تے ورتو تے قدر دے شروع وچ U+001F لاؤ، مثلاً param=%1Fvalue1%1Fvalue2۔ API درخواستاں وچ کجھ پیرامیٹر قسماں کوں ہور وضاحت دی لوڑ ہے:
- boolean
بولین پیرامیٹر HTML چیک باکسز وانگوں کم کریندن: جے پیرامیٹر مخصوص کیتا ونڄے، قدر دی پرواہ کیتے بغیر، اینکوں سچ سمجھیا ویندا ہے۔ غلط قدر کیتے، پیرامیٹر کوں پوری طرح چھوڑ ݙیو۔
- expiry
ختم تھیوݨ دیاں قدراں نسبتّی تھی سڳدیاں ہن (مثلاً 5 months یا 2 weeks) یا مطلق (مثلاً 2014-09-18T12:34:56Z)۔ ختم نہ تھیوݨ کیتے infinite، indefinite، infinity یا never ورتو۔
- timestamp
ٹائم سٹیمپ کئی فارمیٹاں وچ مخصوص کیتے ونڄ سڳدن، تفصیل کیتے the Timestamp library input formats documented on mediawiki.org ݙیکھو۔ ISO 8601 دی تاریخ تے ٹائم دی سفارش کیتی ویندی ہے: 2001-01-15T14:56:00Z۔ موجودہ ٹائم مخصوص کرݨ کیتے now سٹرنگ ورتی ونڄ سڳدی ہے۔
حدود
زیادہ تر API ماڈیول ملٹی ویلیو پیرامیٹراں وچ ٥٠ انپٹس تائیں قبول کر سڳدن، تے ہر سوال تے ٥٠٠ نتائج تائیں واپس کر سڳدن (٥٠ نتائج slow سوالاں کیتے)۔
apihighlimits حق (بوٹ تے منتظمین) آلے ورتݨ آلیاں کیتے، حدود ٥٠٠ انپٹس تے ٥,٠٠٠ نتائج تائیں ودھائی ویندیاں ہن (٥٠٠ نتائج slow سوالاں کیتے)۔
Templated پیرامیٹرز
Templated پیرامیٹر ایہو جہے کیساں دی حمایت کریندن جتھے ہک API ماڈیول کوں کہیں ٻئے پیرامیٹر دی ہر قدر کیتے ہک قدر دی لوڑ ہووے۔ مثلاً، جے پھلاں دی درخواست کرݨ کیتے ہک API ماڈیول ہووے، تاں ایندے وچ fruits پیرامیٹر تھی سڳدا ہے کہ کیرھے پھل منگیے ونڄ پئے ہن، تے {fruit}-quantity ناں دا templated پیرامیٹر کہ ہر پھل دی کنی مقدار منگݨی ہے۔ ہک API کلائنٹ جیندے کوں 1 سیب، 5 کیلے، تے 20 اسٹرابیریز چاہیدے ہن، وت fruits=apples|bananas|strawberries&apples-quantity=1&bananas-quantity=5&strawberries-quantity=20 وانگوں درخواست بݨا سڳدا ہے۔
مرکزی ماڈیول
- ذریعہ: MediaWiki
- لائسنس: GPL-2.0-or-later
Specify the action to perform, the format of the response, and options that apply to all API modules.
- action
کیہڑا عمل انجام ݙیوݨا ہے۔ ڈیبگنگ، تجزیات تے درخواست دی روٹنگ یا فلٹرنگ وچ آسانی کیتے ایہ پیرامیٹر درخواست دے URL دے حصے دے طور تے بھیڄݨا چاہیدا ہے (POST باڈی نئیں)۔
- abusefiltercheckmatch
- Check to see if an AbuseFilter matches a set of variables, an edit, or a logged AbuseFilter event.
- abusefilterchecksyntax
- Check syntax of an AbuseFilter filter.
- abusefilterevalexpression
- Evaluates an AbuseFilter expression.
- abusefilterunblockautopromote
- Unblocks a user from receiving autopromotions due to an abusefilter consequence.
- abuselogprivatedetails
- View private details of an AbuseLog entry.
- acquiretempusername
- ہک عارضی ورتݨ آلے دا ورتݨ ناں حاصل کر کے موجودہ سیشن وچ محفوظ کرو، جے عارضی کھاتہ بݨاوݨ فعال ہے تے موجودہ ورتݨ آلا لاگ آؤٹ ہے۔ جے کوئی ناں پہلے ہی محفوظ کیتا ڳیا ہے تاں اوہو ناں واپس کرو۔
- antispoof
- Check a username against AntiSpoof's normalisation checks.
- block
- ورتُو تے پابندی لاؤ۔
- centralauthtoken
- Fetch a centralauthtoken for making an authenticated request to an attached wiki.
- centralnoticecdncacheupdatebanner
- Request the purge of banner content stored in the CDN (front-end) cache for anonymous users, for the requested banner and language
- centralnoticechoicedata
- Get data needed to choose a banner for a given project and language
- centralnoticequerycampaign
- Get all configuration settings for a campaign.
- changeauthenticationdata
- موجودہ ورتݨ آلے دا تصدیقی ݙیٹا وٹاؤ۔
- changecontentmodel
- ورقے دا مواد ماڈل تبدیل کرو
- checktoken
- action=query&meta=tokens توں ہک ٹوکن دی درستگی دی ڄاݨ کرو۔
- clearhasmsg
- موجودہ ورتݨ آلے کیتے
hasmsgجھنڈا صاف کرو۔ - clientlogin
- انٹریکٹیو بہاؤ نال وکی وچ لاگ ان کرو۔
- communityconfigurationedit
- Change the content of a configuration provider in Community configuration
- compare
- ٻنھ ورقیاں دے درمیان فرق حاصل کرو۔
- createaccount
- ہک نواں ورتݨ آلے دا کھاتہ بݨاؤ۔
- createlocalaccount
- Forcibly create a local account. The central account must exist.
- delete
- ورقہ مٹاؤ
- deleteglobalaccount
- Delete a global user.
- discussiontoolsedit
- Post a message on a discussion page.
- discussiontoolsfindcomment
- Find a comment by its ID or name.
- discussiontoolsgetsubscriptions
- Get the subscription statuses of given topics.
- discussiontoolssubscribe
- Subscribe (or unsubscribe) to receive notifications about a topic.
- discussiontoolsthank
- Send a public thank-you notification for a comment.
- echocreateevent
- Manually trigger a notification to a user
- echomarkread
- Mark notifications as read for the current user.
- echomarkseen
- Mark notifications as seen for the current user.
- echomute
- Mute or unmute notifications from certain users or pages.
- edit
- ورقے بݨاؤ تے لکھو۔
- editmassmessagelist
- Edit a mass message delivery list.
- emailuser
- ورتݨ آلے کوں ای میل کرو
- expandtemplates
- ویکی متن دے اندر سارے سانچے پھیلا ݙیندی ہے۔
- featuredfeed
- Returns a featured content feed.
- feedcontributions
- ورتݨ آلے دے حصے دا فیڈ ݙیندی ہے۔
- feedrecentchanges
- حالیہ تبدیلیاں دا فیڈ واپس کریندی ہے۔
- feedwatchlist
- زیرنظر فہرست دی فیڈ ݙیندی ہے۔
- filerevert
- ہک فائل کوں پراݨے ورژن تے ول ݙیو۔
- globalblock
- Globally block or unblock a user.
- globalpreferenceoverrides
- Change local overrides for global preferences for the current user.
- globalpreferences
- Change global preferences of the current user.
- globaluserrights
- Add/remove a user to/from global groups.
- help
- مخصوص ماڈیولاں کیتے مدد ݙکھاؤ۔
- imagerotate
- ایں ماڈیول کوں غیر فعال کر ݙتا ڳیا ہے۔
- import
- ٻئی وکی توں ورقہ، یا XML فائل توں درآمد کرو۔
- jsonconfig
- Allows direct access to JsonConfig subsystem.
- languagesearch
- کہیں وی رسم الخط وچ زبان دے ناں ڳولو۔
- linkaccount
- تیجے طرف دے فراہم کنندہ توں کھاتہ موجودہ ورتݨ آلے نال جوڑو۔
- login
- لاگ ان کرو تے تصدیق کوکیز حاصل کرو۔
- logout
- لاگ آؤٹ کرو تے سیشن ݙیٹا صاف کرو۔
- managetags
- تبدیلی ٹیگاں نال متعلق انتظامی کم انجام ݙیو۔
- massmessage
- Send a message to a list of pages.
- mergehistory
- ورقیاں دیاں تاریخاں ضم کرو۔
- move
- ورقہ ٹورو۔
- opensearch
- OpenSearch پروٹوکول استعمال کر کے وکی وچ ڳولو۔
- options
- موجودہ ورتݨ آلے دیاں ترجیحاں تبدیل کرو۔
- paraminfo
- API ماڈیولاں بارے معلومات حاصل کرو۔
- parse
- مواد پارش کریندے تے پارسر آؤٹ پٹ واپس ݙیندے۔
- patrol
- ہک ورقے یا نسخے دی گشت کرو۔
- protect
- ہک ورقے دا حفاظت درجہ تبدیل کرو۔
- purge
- ݙتیاں ڳئیاں سرخیاں کیتے کیش صاف کرو۔
- query
- میڈیاوکی کنوں تے میڈیاوکی بارے ڈیٹا گھنو۔
- removeauthenticationdata
- موجودہ ورتݨ آلے دا تصدیقی ڈیٹا ہٹاؤ۔
- resetpassword
- ہک ورتݨ آلے کوں پاس ورڈ ری سیٹ دی ای میل بھیجو۔
- revisiondelete
- نسخے مٹاؤ تے بحال کرو۔
- rollback
- ورقے دی آخری ترمیم واپس کرو۔
- rsd
- ہک RSD (Really Simple Discovery) اسکیما برآمد کرو۔
- setglobalaccountstatus
- Hide or lock (or unhide or unlock) a global user account.
- setnotificationtimestamp
- زیرنظر ورقیاں کیتے اطلاع دے ٹائم سٹیمپ کوں اپ ڈیٹ کرو۔
- setpagelanguage
- ہک ورقے دی زبان تبدیل کرو۔
- shortenurl
- Shorten a long URL into a shorter one.
- sitematrix
- Get Wikimedia sites list.
- spamblacklist
- Validate one or more URLs against the spam block list.
- streamconfigs
- Exposes event stream config. Returns only format=json with formatversion=2.
- strikevote
- Allows admins to strike or unstrike a vote.
- tag
- انفرادی نسخیاں یا لاگ اندراجاں وچوں تبدیلی دے ٹیگ ودھاؤ یا ہٹاؤ۔
- templatedata
- Fetch data stored by the TemplateData extension.
- thank
- Send a thank-you notification to an editor.
- titleblacklist
- Validate a page title, filename, or username against the TitleBlacklist.
- torblock
- Check if an IP address is blocked as a Tor exit node.
- transcodereset
- Users with the 'transcode-reset' right can reset and re-run a transcode job.
- unblock
- ہک ورتݨ آلے کنوں پابندی ہٹاؤ۔
- undelete
- مٹے ڳئے ورقے دے نسخے بحال کرو۔
- unlinkaccount
- موجودہ ورتݨ آلے کنوں ڳݨڈھیلا تھرڈ پارٹی کھاتا ہٹاؤ۔
- upload
- ہک فائل اپ لوڈ کرو، یا زیرالتواء اپ لوڈز دی حالت گھنو۔
- userrights
- ہک ورتݨ آلے دی گروہ رکنیت تبدیل کرو۔
- validatepassword
- وکی دیاں پاس ورڈ پالیسیاں دے مطابق ہک پاس ورڈ دی توثیق کرو۔
- watch
- موجودہ ورتݨ آلے دی زیرنظر فہرست وچ ورقے ودھاؤ یا ہٹاؤ۔
- webapp-manifest
- Returns a webapp manifest.
- webauthn
- API Module to communicate between server and client during registration/authentication process.
- wikifunctions_run
- Run a function call
- wikilambda_fetch
- Fetch the JSON model of ZObjects.
- abstractwiki_fetch_section
- اندرونی۔ Request the currently available Abstract Wikipedia rendered fragments for the given topic Qid (Wikidata Item Id), section Qid, language Zid and date. Alternatively (and only with special rights), request the currently available rendered output of an array of fragments passed in the request, which can be different from the currently persisted version.
This request is never blocking. When any of the requested fragments is not ready, the returned value for that fragment will have a "pending" flag set to true.
The response is always guaranteed to return as many results as requested. For example, if the "fragments" param is empty and the requested section has N fragments, all N will be returned; similarly, if M fragments are requested in the "fragments" parameter, the respond will return M items.
- abstractwiki_run_fragment
- اندرونی۔ Render an Abstract Wikipedia content fragment for the given Wikidata Item Id, language Zid and date
- bouncehandler
- اندرونی۔ Receive a bounce email and process it to handle the failing recipient.
- categorytree
- اندرونی۔ Internal module for the CategoryTree extension.
- chartinfo
- اندرونی۔ Retrieve current count of how many unique Chart page usages there are. Multiple uses of the same chart on the same page are considered a single use.
- cirrus-check-sanity
- اندرونی۔ Reports on the correctness of a range of page ids in the search index
- cirrus-config-dump
- اندرونی۔ Dump of CirrusSearch configuration.
- cirrus-profiles-dump
- اندرونی۔ Dump of CirrusSearch profiles for this wiki.
- cirrus-schema-dump
- اندرونی۔ Dump of CirrusSearch schema (settings and mappings) for this wiki.
- codemirror-validate
- اندرونی۔ Check for validation errors in the given content
- collection
- اندرونی۔ API module for performing various operations on a wiki user's collection.
- cspreport
- اندرونی۔ Content Security Policy دیاں خلاف ورزیاں دی رپورٹ کرݨ کیتے براؤزراں دے ذریعے ورتیا ونڄݨا۔ ایں ماڈیول کوں کݙاہیں ورتیا نئیں ونڄݨا چاہیدا، سوائے اوں وقت دے جڈاں ایں کوں CSP دے مطابق ویب براؤزر دے ذریعے خودکار طور تے ورتیا ونڄے۔
- discussiontoolscompare
- اندرونی۔ Get information about comment changes between two page revisions.
- discussiontoolspageinfo
- اندرونی۔ Returns metadata required to initialize the discussion tools.
- discussiontoolspreview
- اندرونی۔ Preview a message on a discussion page.
- editcheckreferenceurl
- اندرونی۔ Check the status of a URL for use as a reference.
- fancycaptchareload
- اندرونی۔ نواں سوہݨاکیپچا گھنو
- jsondata
- اندرونی۔ Retrieve localized JSON data.
- jsontransform
- اندرونی۔ Retrieve JSON data transformed by a Lua function.
- parser-migration
- اندرونی۔ Parse a page with two different parser configurations.
- readinglists
- اندرونی۔ Reading list write operations.
- sanitize-mapdata
- اندرونی۔ Performs data validation for Kartographer extension
- scribunto-console
- اندرونی۔ Internal module for servicing XHR requests from the Scribunto console.
- securepollauth
- اندرونی۔ Allows a remote wiki to authenticate users before granting access to vote in the election.
- stashedit
- اندرونی۔ مشترکہ کیش وچ ہک ترمیم تیار کرو۔
- timedtext
- اندرونی۔ Provides timed text content for usage by <track> elements
- ulslocalization
- اندرونی۔ Get the localization of ULS in the given language.
- ulssetlang
- اندرونی۔ Update user's preferred interface language.
- visualeditor
- اندرونی۔ Returns HTML5 for a page from the Parsoid service.
- visualeditoredit
- اندرونی۔ Save an HTML5 page to MediaWiki (converted to wikitext via the Parsoid service).
- wikifunctions_html_sanitiser
- اندرونی۔ API to sanitise a string of HTML for user-facing display on Wikifunctions.org and client Wikimedia wikis.
- wikilambda_edit
- اندرونی۔ Create or edit a ZObject.
- wikilambda_function_call
- اندرونی۔ Invoke a function by calling the function-orchestrator
- wikilambda_perform_test
- اندرونی۔ Endpoint to query test results for a ZFunction. Accepts a ZFunction, a list of ZImplementations, and a list of ZTesters. Accepts either a list of ZIDs or the full ZObject for the function, implementations, or testers. Also accepts a key to utilize a back end cache or not.
- wikilambda_supported_programming_languages
- اندرونی۔ Retrieve the programming languages supported by the evaluator
- wikimediaeventsblockededit
- اندرونی۔ Log information about blocked edit attempts
- wikimediaeventshcaptchaeditattempt
- اندرونی۔ Log edit diff when hCaptcha challenge is shown but edit is incomplete
- درج ذیل قدراں وچوں ہک: abusefiltercheckmatch, abusefilterchecksyntax, abusefilterevalexpression, abusefilterunblockautopromote, abuselogprivatedetails, acquiretempusername, antispoof, block, centralauthtoken, centralnoticecdncacheupdatebanner, centralnoticechoicedata, centralnoticequerycampaign, changeauthenticationdata, changecontentmodel, checktoken, clearhasmsg, clientlogin, communityconfigurationedit, compare, createaccount, createlocalaccount, delete, deleteglobalaccount, discussiontoolsedit, discussiontoolsfindcomment, discussiontoolsgetsubscriptions, discussiontoolssubscribe, discussiontoolsthank, echocreateevent, echomarkread, echomarkseen, echomute, edit, editmassmessagelist, emailuser, expandtemplates, featuredfeed, feedcontributions, feedrecentchanges, feedwatchlist, filerevert, globalblock, globalpreferenceoverrides, globalpreferences, globaluserrights, help, imagerotate, import, jsonconfig, languagesearch, linkaccount, login, logout, managetags, massmessage, mergehistory, move, opensearch, options, paraminfo, parse, patrol, protect, purge, query, removeauthenticationdata, resetpassword, revisiondelete, rollback, rsd, setglobalaccountstatus, setnotificationtimestamp, setpagelanguage, shortenurl, sitematrix, spamblacklist, streamconfigs, strikevote, tag, templatedata, thank, titleblacklist, torblock, transcodereset, unblock, undelete, unlinkaccount, upload, userrights, validatepassword, watch, webapp-manifest, webauthn, wikifunctions_run, wikilambda_fetch, abstractwiki_fetch_section, abstractwiki_run_fragment, bouncehandler, categorytree, chartinfo, cirrus-check-sanity, cirrus-config-dump, cirrus-profiles-dump, cirrus-schema-dump, codemirror-validate, collection, cspreport, discussiontoolscompare, discussiontoolspageinfo, discussiontoolspreview, editcheckreferenceurl, fancycaptchareload, jsondata, jsontransform, parser-migration, readinglists, sanitize-mapdata, scribunto-console, securepollauth, stashedit, timedtext, ulslocalization, ulssetlang, visualeditor, visualeditoredit, wikifunctions_html_sanitiser, wikilambda_edit, wikilambda_function_call, wikilambda_perform_test, wikilambda_supported_programming_languages, wikimediaeventsblockededit, wikimediaeventshcaptchaeditattempt
- Default: help
- format
آؤٹ پٹ دا فارمیٹ۔
- json
- JSON فارمیٹ وچ ڈیٹا آؤٹ پٹ کرو۔
- jsonfm
- HTML وچ صاف چھپائی نال JSON فارمیٹ وچ ڈیٹا آؤٹ پٹ کرو۔
- none
- کجھ وی آؤٹ پٹ نہ کرو۔
- rawfm
- ڈیبگنگ عناصر سمیت ڈیٹا، HTML وچ صاف چھپائی نال JSON فارمیٹ وچ آؤٹ پٹ کرو۔
- xml
- XML فارمیٹ وچ ڈیٹا آؤٹ پٹ کرو۔
- xmlfm
- HTML وچ صاف چھپائی نال XML فارمیٹ وچ ڈیٹا آؤٹ پٹ کرو۔
- درج ذیل قدراں وچوں ہک: json, jsonfm, none, rawfm, xml, xmlfm
- Default: jsonfm
- maxlag
وڈا lag اوں ویلے ورتیا ونڄ سڳدا ہے جڈاں MediaWiki ݙیٹابیس replicated cluster تے نصب ہووے۔ سائٹ دے replication lag کوں ٻیا ودھاوݨ آلیاں کارروائیاں توں بچݨ کیتے، ایہ پیرامیٹر کلائنٹ کوں اوں ویلے تائیں انتظار کراوݨا ہے جڈاں تائیں replication lag مخصوص قدر توں گھٹ نہ تھی ونڄے۔ بے حد lag دی صورت وچ، نقص کوڈ maxlag اینجھے پیغام نال واپس ملدا ہے Waiting for $host: $lag seconds lagged۔
مزید معلومات کیتے Maxlag پیرامیٹر دستی ݙیکھو۔- Type: integer
- smaxage
HTTP کیش کنٹرول ہیڈر کوں اینے سیکنڈاں تائیں
s-maxageتے سیٹ کرو۔ نقص کݙاہیں کیش نئیں کیتے ویندے۔- Type: integer
- The value must be no less than ٠.
- Default: 0
- maxage
HTTP کیش کنٹرول ہیڈر کوں اینے سیکنڈاں تائیں
max-ageتے سیٹ کرو۔ نقص کݙاہیں کیش نئیں کیتے ویندے۔- Type: integer
- The value must be no less than ٠.
- Default: 0
- assert
تصدیق کرو جو ورتݨ آلا لاگ ان ہے (شاید عارضی ورتݨ آلے دے طور تے وی) جے ایہ user تے سیٹ ہووے، not لاگ ان ہووے جے anon تے سیٹ ہووے، یا بوٹ ورتݨ آلے دا حق رکھدا ہووے جے bot ہووے۔
- درج ذیل قدراں وچوں ہک: anon, bot, user
- assertuser
تصدیق کرو جو موجودہ ورتݨ آلا ناں ݙتا ہویا ورتݨ آلا ہے۔
- قسم: ورتݨ آلا، ٻیاں وچوں ورتݨ ناں تے عارضی ورتݨ آلا
- requestid
اتھاں ݙتی ڳئی کوئی وی قدر جواب وچ شامل کیتی ونڄسی۔ درخواستاں کوں انج کرݨ کیتے ورتی ونڄ سڳدی ہے۔
- servedby
جیہڑے ہوسٹ نے درخواست کوں جواب ݙتا، ایندا hostname نتیجیاں وچ شامل کرو۔
- قسم: بولین (تفصیل)
- curtimestamp
نتیجے وچ موجودہ ٹائم اسٹیمپ شامل کرو۔
- قسم: بولین (تفصیل)
- responselanginfo
نتیجے وچ uselang تے errorlang کیتے ورتیاں ڳئیاں زباناں شامل کرو۔
- قسم: بولین (تفصیل)
- origin
جڈاں API تائیں cross-domain AJAX درخواست (CORS) دے ذریعے رسائی حاصل کیتی ونڄے، تاں ایں کوں originating domain تے سیٹ کرو۔ ایہ ہر pre-flight درخواست وچ شامل ہووݨا چاہیدا ہے، اتے ایں وجہ توں درخواست دے URL دا حصہ ہووݨا چاہیدا ہے (POST body دا نئیں)۔
تصدیق شدہ درخاستاں کیتے، ایہ
Originheader وچوں ہک origin نال بالکل ملݨا چاہیدا ہے، ایں وجہ توں ایہ https://en.wikipedia.org یا https://meta.wikimedia.org ورگے کجھ تے سیٹ ہووݨا چاہیدا ہے۔ جے ایہ پیرامیٹرOriginheader نال نئیں ملدا، تاں 403 جواب واپس آوے ڳا۔ جے ایہ پیرامیٹرOriginheader نال ملدا ہے اتے origin دی اجازت ہے، تاںAccess-Control-Allow-OriginاتےAccess-Control-Allow-Credentialsheaders سیٹ کیتیاں ونڄسن۔غیر تصدیق شدہ درخاستاں کیتے، قدر * ݙسو۔ ایندے نال
Access-Control-Allow-Originheader سیٹ تھی ویسے، لیکنAccess-Control-Allow-Credentialsfalseہووے ڳا اتے ورتݨ آلے دی ساری مخصوص ݙیٹا محدود کر ݙتی ویسے۔- crossorigin
جڈاں API تائیں cross-domain AJAX درخواست (CORS) دے ذریعے رسائی حاصل کیتی ونڄے اتے ہک اینجھا session provider ورتیا ونڄے جیہڑا cross-site request forgery (CSRF) حملیاں توں محفوظ ہے (جیویں OAuth)، تاں درخواست کوں تصدیق شدہ (یعنی لاگ آؤٹ نئیں) بݨاوݨ کیتے ایندے بجاے
origin=*ورتو۔ ایہ ہر pre-flight درخواست وچ شامل ہووݨا چاہیدا ہے، اتے ایں وجہ توں درخواست دے URL دا حصہ ہووݨا چاہیدا ہے (POST body دا نئیں)۔نوٹ کرو جو زیادہ تر session providers، جنہاں وچ معیاری cookie-based sessions شامل ہن، تصدیق شدہ CORS دی حمایت نئیں کریندے اتے ایں پیرامیٹر نال نئیں ورتے ونڄ سڳدے۔
- قسم: بولین (تفصیل)
- uselang
پیغام دے ترجمے کیتے ورتی ونڄݨ آلی زبان۔ action=query&meta=siteinfo&siprop=languages زباناں دے کوڈاں دی فہرست واپس ݙیندا ہے۔ تساں موجودہ ورتݨ آلے دی زبان دی ترجیح ورتݨ کیتے user یا ایں وکی دی مواد دی زبان ورتݨ کیتے content ݙس سڳدے ہو۔
- Default: user
- variant
زبان دی قسم۔ صرف اوں ویلے کم کریندی ہے جے بنیادی زبان قسم دی تبدیلی دی حمایت کریندی ہے۔
- errorformat
انتباہ تے نقص دے متن دے آؤٹ پٹ کیتے ورتی ونڄݨ آلا فارمیٹ
- plaintext
- HTML ٹیگز ہٹا کے تے entities دی جاہ تے رکھ کے وکی متن۔
- wikitext
- بغیر تجزیہ شدہ وکی متن۔
- html
- HTML
- raw
- پیغام دی کنجی تے پیرامیٹرز۔
- none
- کوئی متن آؤٹ پٹ کائنی، صرف نقص کوڈز۔
- bc
- MediaWiki 1.29 توں پہلے ورتیا ونڄݨ آلا فارمیٹ۔ errorlang تے errorsuselocal نظر انداز کیتے ویندن۔
- درج ذیل قدراں وچوں ہک: bc, html, none, plaintext, raw, wikitext
- Default: bc
- errorlang
انتباہات تے نقصاں کیتے ورتی ونڄݨ آلی زبان۔ action=query&meta=siteinfo&siprop=languages زبان دے کوڈاں دی ہک فہرست موڑدا ہے۔ content لکھو ایں وکی دی مواد دی زبان ورتݨ کیتے یا uselang uselang پیرامیٹر دی قدر ورتݨ کیتے۔
- Default: uselang
- errorsuselocal
جے ݙتا ڳیا، تاں نقص دے متن میڈیا وکی ناں تھاں توں مقامی طور تے تخصیص شدہ پیغام ورتسن۔
- قسم: بولین (تفصیل)
- centralauthtoken
When accessing the API using a cross-domain AJAX request (CORS), use this to authenticate as the current SUL user. Use action=centralauthtoken on this wiki to retrieve the token, before making the CORS request. Each token may only be used once, and expires after ٦٠ seconds. This should be included in any pre-flight request, and therefore should be included in the request URI (not the POST body).
On this wiki the expected value is a JSON Web Token, which may be validated by proxy servers in front of MediaWiki. If the token has expired or is otherwise invalid, you may receive a HTTP error from a proxy in a different format than a normal API error.
- اہم ماڈیول کیتے مدد۔
- api.php?action=help [سینڈ باکس وچ کھولو]
- ہک ورقے وچ ساری مدد۔
- api.php?action=help&recursivesubmodules=1&toc [سینڈ باکس وچ کھولو]
Credits
API developers:
- Yuri Astrakhan (creator, lead developer Sep 2006–Sep 2007)
- Roan Kattouw (lead developer Sep 2007–2009)
- Victor Vasiliev
- Bryan Tong Minh
- Sam Reed
- Brad Jorsch (lead developer 2013–2020)
Please send your comments, suggestions and questions to mediawiki-api@lists.wikimedia.org or file a bug report at https://phabricator.wikimedia.org/.