MediaWiki API مدد

ایہ MediaWiki Action API دا خودکار طور تے بݨایا ڳیا دستاویزی ورقہ ہے۔

عام معلومات

حالت: MediaWiki API ہک پختہ تے مستحکم انٹرفیس ہے جیندے کوں فعال طور تے سہارا ݙتا ویندا ہے تے بہتر بݨایا ویندا ہے۔ جے اساں ایں کنوں بچݨ دی کوشش کریندے ہیں، اساں کوں کݙاہیں کݙاہیں breaking تبدیلیاں کرݨ دی لوڑ پو سڳدی ہے؛ اپ ڈیٹس دی اطلاع کیتے mediawiki-api-announce میلنگ لسٹ تے سبسکرائب کرو۔ غلط درخواستیں: جڈاں API کوں غلط درخواستیں بھیجیاں ویندیاں ہن، تاں "MediaWiki-API-Error" کلید نال ہک HTTP ہیڈر بھیجیا ویندا ہے تے وت ہیڈر دی قدر تے واپس بھیجے ڳئے غلطی دے کوڈ ݙوہائیں کوں ہکے قدر تے سیٹ کیتا ویندا ہے۔ مزید معلومات کیتے API: غلطیاں تے خبرداریاں ݙیکھو۔

درخواست دے طریقے

ایکشن 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 وانگوں درخواست بݨا سڳدا ہے۔

مرکزی ماڈیول

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 دا نئیں)۔

تصدیق شدہ درخاستاں کیتے، ایہ Origin header وچوں ہک origin نال بالکل ملݨا چاہیدا ہے، ایں وجہ توں ایہ https://en.wikipedia.org یا https://meta.wikimedia.org ورگے کجھ تے سیٹ ہووݨا چاہیدا ہے۔ جے ایہ پیرامیٹر Origin header نال نئیں ملدا، تاں 403 جواب واپس آوے ڳا۔ جے ایہ پیرامیٹر Origin header نال ملدا ہے اتے origin دی اجازت ہے، تاں Access-Control-Allow-Origin اتے Access-Control-Allow-Credentials headers سیٹ کیتیاں ونڄسن۔

غیر تصدیق شدہ درخاستاں کیتے، قدر * ݙسو۔ ایندے نال Access-Control-Allow-Origin header سیٹ تھی ویسے، لیکن Access-Control-Allow-Credentials false ہووے ڳا اتے ورتݨ آلے دی ساری مخصوص ݙیٹا محدود کر ݙتی ویسے۔

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.

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/.