MediaWiki API sugo

Ez egy automatikusan generalt MediaWiki-API-dokumentacios lap.

Dokumentacio es peldak: https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page

F? modul

Allapot: A MediaWiki API egy erett es stabil interfesz, ami aktiv tamogatasban es fejlesztesben reszesul. Bar probaljuk elkerulni, de neha szukseg van visszafele nem kompatibilis valtoztatasokra; iratkozz fel a mediawiki-api-announce levelez?listara a frissitesek kovetesehez.

Hibas keresek: Ha az API hibas kerest kap, egy HTTP-fejlecet kuld vissza ?MediaWiki-API-Error” kulccsal, es a fejlec erteke es a visszakuldott hibakod ugyanarra az ertekre lesz allitva. Tovabbi informacioert lasd: API: Hibak es figyelmeztetesek .

Jellemz? parameterek:
action

Milyen m?veletet hajtson vegre.

abusefiltercheckmatch
Check to see if an AbuseFilter matches a set of variables, an edit, or a logged AbuseFilter event.
abusefilterchecksyntax
Egy Vandalsz?r? szintaxisanak ellen?rzese.
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
Acquire a temporary user username and stash it in the current session, if temp account creation is enabled and the current user is logged out. If a name has already been stashed, returns the same name.
antispoof
Check a username against AntiSpoof's normalisation checks.
block
Szerkeszt? blokkolasa
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
Change authentication data for the current user.
changecontentmodel
Change the content model of a page
checktoken
Egy action=query&meta=tokens keressel szerzett token ervenyessegenek vizsgalata.
cirrus-config-dump
Dump of CirrusSearch configuration.
cirrus-mapping-dump
Dump of CirrusSearch mapping for this wiki.
cirrus-profiles-dump
Dump of CirrusSearch profiles for this wiki.
cirrus-settings-dump
Dump of CirrusSearch settings for this wiki.
clearhasmsg
A hasmsg jelzes torlese az aktualis felhasznalonak.
clientlogin
Log in to the wiki using the interactive flow.
compare
Ket lap kozotti kulonbseg kiszamitasa.
createaccount
Uj felhasznaloi fiok letrehozasa.
createlocalaccount
Forcibly create a local account. The central account must exist.
cxdelete
Delete a draft translation created using the Content Translation extension.
cxsuggestionlist
Manage the suggestion lists. Add suggestions to lists and remove them.
cxtoken
Get JWT tokens to authenticate with cxserver.
delete
Lap torlese.
deleteglobalaccount
Delete a global user.
discussiontoolsedit
Uzenet elkuldese egy vitalapra.
discussiontoolsfindcomment
Find a comment by its ID or name.
discussiontoolsgetsubscriptions
Adott temak feliratkozasi allapotanak lekerdezese.
discussiontoolssubscribe
Feliratkozas (vagy leiratkozas) egy adott tema ertesiteseir?l.
echocreateevent
Manually trigger a notification to a user
echomarkread
A jelenlegi felhasznalo ertesiteseinek olvasottnak jelolese.
echomarkseen
Ertesitesek latottnak jelolese az aktualis felhasznalo szamara.
echomute
Ertesitesek nemitasa vagy engedelyezese bizonyos felhasznaloktol vagy bizonyos lapokhoz kapcsolodoan.
edit
Lapok letrehozasa es szerkesztese.
editmassmessagelist
Edit a mass message delivery list.
emailuser
E-mail kuldese
expandtemplates
Minden sablon kibontasa a wikiszovegben.
featuredfeed
Returns a featured content feed.
feedcontributions
Egy felhasznalo kozrem?kodeseinek lekerese hircsatornakent.
feedrecentchanges
A friss valtoztatasok lekerese hircsatornakent.
feedthreads
Megbeszelesszalak lekerese hircsatornakent.
feedwatchlist
A figyel?lista lekerese hircsatornakent.
filerevert
Egy fajl visszaallitasa egy regebbi verziora.
flagconfig
Alapvet? informaciok lekerese a jelolt lapvaltozatok konfiguraciojarol ezen a wikin.
globalblock
Egy felhasznalo globalis blokkolasa vagy blokkjanak feloldasa.
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.
growthmanagementorlist
Kezeld az informaciokat a strukturalt mentorlistaban (altalaban a MediaWiki:GrowthMentors.json fajlban tarolt). Ezt a modult mind a jelenlegi es jov?beli mentorok (hogy hozzaadjak magukat vagy megvaltoztassak adataikat), mind az adminisztratorok (minden felhasznalo szamara) egyarant hasznalhatjak.
growthmentordashboardupdatedata
A mentor iranyitopultjan talalhato, a mentoraltak attekint? moduljanak rendkivuli frissiteset utemezd be. Teljesit?kepessegi okokbol ket orankent csak egy frissitest lehet utemezni.
growthsetmenteestatus
Mentoralt allapotanak beallitasa (lehet?ve teszi a mentoralt szamara a mentori modul engedelyezeset/letiltasat, vagy a teljes leiratkozast, ami torli a mentoralt/mentor kapcsolatot)
growthsetmentor
Egy felhasznalo mentoranak megvaltoztatasa. A valtoztatas nyilvanosan naplozva lesz.
growthstarmentee
Mentoralt megjelolese vagy jelolesenek torlese az aktualis felhasznalo altal csillagozottkent (privat tarolas es nem naplozott)
help
Sugo megjelenitese a megadott modulokhoz.
homepagequestionstore
A kezd?lapi modulon keresztul kozzetett formazott kerdesek elerese.
imagerotate
Ez a modul le lett tiltva.
import
Egy lap importalasa egy masik wikib?l vagy XML-fajlbol.
jsonconfig
Kozvetlen hozzaferes a JsonConfig alrendszerhez.
languagesearch
Nyelvnevek keresese barmilyen irasrendszerrel.
linkaccount
Egy harmadik fel szolgaltato fiokjanak kapcsolasa a jelenlegi felhasznalohoz.
login
Bejelentkezes es hitelesit? sutik lekerese.
logout
Kijelentkezes es munkamenetadatok torlese.
managetags
A valtoztatascimkek kezelese.
massmessage
Send a message to a list of pages.
mergehistory
Laptortenetek egyesitese
move
Egy lap atnevezese.
opensearch
Kereses a wikin az OpenSearch protokoll segitsegevel.
options
A jelenlegi felhasznalo beallitasainak modositasa.
paraminfo
Informaciok lekerese API-modulokrol.
parse
Tartalom feldolgozasa.
patrol
Egy lap vagy lapvaltozat ellen?rzottnek jelolese (patrol).
protect
Egy lap vedelmi szintjenek valtoztatasa.
purge
A gyorsitotar uritese a megadott lapoknal.
query
Adatok lekerese a MediaWikib?l es a MediaWikir?l.
removeauthenticationdata
A jelenlegi felhasznalo hitelesitesi adatainak eltavolitasa.
resetpassword
Jelszo-visszaallito e-mail kuldese a felhasznalonak.
review
Egy lapvaltozat ellen?rzese az elfogadasaval vagy ellen?rizetlennek jelolesevel.
revisiondelete
Valtozatok torlese es helyreallitasa.
rollback
A lap legutobbi valtoztatasanak visszavonasa.
rsd
Egy RSD-sema (Really Simple Discovery) exportalasa.
setglobalaccountstatus
Hide or lock (or unhide or unlock) a global user account.
setnotificationtimestamp
A figyelt lapok ertesitesi id?belyegenek frissitese.
setpagelanguage
Egy lap nyelvenek modositasa.
shortenurl
Egy hosszu URL roviditese.
sitematrix
Get Wikimedia sites list.
spamblacklist
Validate one or more URLs against the spam block list.
stabilize
Change page stability settings.
streamconfigs
Exposes event stream config. Returns only format=json with formatversion=2.
strikevote
Allows admins to strike or unstrike a vote.
sxdelete
Delete the draft section translation and its parallel corpora from database.
tag
Add or remove change tags from individual revisions or log entries.
templatedata
A TemplateData kiterjesztes altal tarolt adatok lekerdezese.
thank
Koszonet kuldese egy szerkeszt?nek.
threadaction
Lehet?ve teszi m?veletek vegzeset szalakon es szalakat hasznalo beszelgetesek hozzaszolasain.
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
Unblock a user.
undelete
Undelete revisions of a deleted page.
unlinkaccount
Remove a linked third-party account from the current user.
upload
Upload a file, or get the status of pending uploads.
userrights
Change a user's group membership.
validatepassword
Validate a password against the wiki's password policies.
watch
Add or remove pages from the current user's watchlist.
webapp-manifest
Returns a webapp manifest.
webauthn
API Module to communicate between server and client during registration/authentication process.
wikilove
Give WikiLove to another user.
bouncehandler
Bels?. Receive a bounce email and process it to handle the failing recipient.
categorytree
Bels?. A CategoryTree kiterjesztes bels? modulja.
cirrus-check-sanity
Bels?. Reports on the correctness of a range of page ids in the search index
collection
Bels?. API module for performing various operations on a wiki user's collection.
cspreport
Bels?. Used by browsers to report violations of the Content Security Policy. This module should never be used, except when used automatically by a CSP compliant web browser.
cxcheckunreviewed
Bels?. Check if any fast, unreviewed translation has been published recently for the current user.
cxpublish
Bels?. Save a page created using the Content Translation extension.
cxpublishsection
Bels?. Save a section created using the Content Translation extension's section translation feature.
cxsave
Bels?. This module allows to save draft translations by section to save bandwidth and to collect parallel corpora.
cxsplit
Bels?. Create and save a section translation to database, for every translated section of the given article translation
discussiontoolscompare
Bels?. Informaciok lekerese ket lapvaltozat kozotti hozzaszolas-valtozasokrol.
discussiontoolspageinfo
Bels?. A megbeszeleseszkozok inicializalasahoz szukseges metaadatok lekerese.
discussiontoolspreview
Bels?. Egy uzenet el?nezetenek megjelenitese egy vitalapon.
echopushsubscriptions
Bels?. A jelenlegi felhasznalo lekuldeses ertesiteseinek kezelese.
editcheckreferenceurl
Bels?. Check the status of a URL for use as a reference.
fancycaptchareload
Bels?. Get a new FancyCaptcha.
growthinvalidateimagerecommendation
Bels?. A kepajanlasi feladat ervenytelen
growthinvalidatepersonalizedpraisesuggestion
Bels?. Invalidates a suggestion of a praiseworthy mentee in the Personalized praise module on the Mentor dashboard
helppanelquestionposter
Bels?. A sugomodulon keresztul kozzetett kerdes kezelese az aktualis szerkeszt? szamara.
jsondata
Bels?. Lokalizalt JSON-adatok lekerese.
oathvalidate
Bels?. Validate a two-factor authentication (OATH) token.
parser-migration
Bels?. Parse a page with two different parser configurations.
readinglists
Bels?. Reading list write operations.
sanitize-mapdata
Bels?. Performs data validation for Kartographer extension
scribunto-console
Bels?. Bels? modul a Scribunto konzolrol erkez? XHR-keresek kiszolgalasara.
securepollauth
Bels?. Allows a remote wiki to authenticate users before granting access to vote in the election.
stashedit
Bels?. Egy szerkesztes el?keszitese a megosztott gyorsitotarban.
sxsave
Bels?. Save the draft section translation and store the parallel corpora
timedtext
Bels?. Provides timed text content for usage by <track> elements
ulslocalization
Bels?. Az ULS forditasanak lekerese egy adott nyelven.
ulssetlang
Bels?. Update user's preferred interface language.
visualeditor
Bels?. A Parsoid szolgaltatastol kapott oldalbol HTML5 oldalt keszit.
visualeditoredit
Bels?. HTML5 oldal elmentese a wikiben (a Parsoid szolgaltatassal wikiszovegge konvertalva).
wikimediaeventsblockededit
Bels?. Log information about blocked edit attempts
A kovetkez? ertekek egyike: abusefiltercheckmatch , abusefilterchecksyntax , abusefilterevalexpression , abusefilterunblockautopromote , abuselogprivatedetails , acquiretempusername , antispoof , block , centralauthtoken , centralnoticecdncacheupdatebanner , centralnoticechoicedata , centralnoticequerycampaign , changeauthenticationdata , changecontentmodel , checktoken , cirrus-config-dump , cirrus-mapping-dump , cirrus-profiles-dump , cirrus-settings-dump , clearhasmsg , clientlogin , compare , createaccount , createlocalaccount , cxdelete , cxsuggestionlist , cxtoken , delete , deleteglobalaccount , discussiontoolsedit , discussiontoolsfindcomment , discussiontoolsgetsubscriptions , discussiontoolssubscribe , echocreateevent , echomarkread , echomarkseen , echomute , edit , editmassmessagelist , emailuser , expandtemplates , featuredfeed , feedcontributions , feedrecentchanges , feedthreads , feedwatchlist , filerevert , flagconfig , globalblock , globalpreferenceoverrides , globalpreferences , globaluserrights , growthmanagementorlist , growthmentordashboardupdatedata , growthsetmenteestatus , growthsetmentor , growthstarmentee , help , homepagequestionstore , imagerotate , import , jsonconfig , languagesearch , linkaccount , login , logout , managetags , massmessage , mergehistory , move , opensearch , options , paraminfo , parse , patrol , protect , purge , query , removeauthenticationdata , resetpassword , review , revisiondelete , rollback , rsd , setglobalaccountstatus , setnotificationtimestamp , setpagelanguage , shortenurl , sitematrix , spamblacklist , stabilize , streamconfigs , strikevote , sxdelete , tag , templatedata , thank , threadaction , titleblacklist , torblock , transcodereset , unblock , undelete , unlinkaccount , upload , userrights , validatepassword , watch , webapp-manifest , webauthn , wikilove , bouncehandler , categorytree , cirrus-check-sanity , collection , cspreport , cxcheckunreviewed , cxpublish , cxpublishsection , cxsave , cxsplit , discussiontoolscompare , discussiontoolspageinfo , discussiontoolspreview , echopushsubscriptions , editcheckreferenceurl , fancycaptchareload , growthinvalidateimagerecommendation , growthinvalidatepersonalizedpraisesuggestion , helppanelquestionposter , jsondata , oathvalidate , parser-migration , readinglists , sanitize-mapdata , scribunto-console , securepollauth , stashedit , sxsave , timedtext , ulslocalization , ulssetlang , visualeditor , visualeditoredit , wikimediaeventsblockededit
Alapertelmezett: help
format

A kimenet formatuma.

json
Output data in JSON format.
jsonfm
Output data in JSON format (pretty-print in HTML).
none
Output nothing.
php
Output data in serialized PHP format.
phpfm
Output data in serialized PHP format (pretty-print in HTML).
rawfm
Output data, including debugging elements, in JSON format (pretty-print in HTML).
xml
Output data in XML format.
xmlfm
Output data in XML format (pretty-print in HTML).
A kovetkez? ertekek egyike: json , jsonfm , none , php , phpfm , rawfm , xml , xmlfm
Alapertelmezett: jsonfm
maxlag

Maximum lag can be used when MediaWiki is installed on a database replicated cluster. To save actions causing any more site replication lag, this parameter can make the client wait until the replication lag is less than the specified value. In case of excessive lag, error code maxlag is returned with a message like Waiting for $host: $lag seconds lagged .
See Manual: Maxlag parameter for more information.

Tipus: egesz szam
smaxage

Az s-maxage gyorsitotar-vezerl? HTTP-fejlec beallitasa ennyi masodpercre. A hibak soha nincsenek gyorsitotarazva.

Tipus: egesz szam
Az ertek nem lehet kisebb mint 0.
Alapertelmezett: 0
maxage

Az maxage gyorsitotar-vezerl? HTTP-fejlec beallitasa ennyi masodpercre. A hibak soha nincsenek gyorsitotarazva.

Tipus: egesz szam
Az ertek nem lehet kisebb mint 0.
Alapertelmezett: 0
assert

Annak ellen?rzese, hogy a felhasznalo be van-e jelentkezve (akar egy ideiglenes felhasznaloval) user ertek eseten, illetve ki van-e jelentkezve anon eseten, vagy botjog ellen?rzese bot ertek eseten.

A kovetkez? ertekek egyike: anon, bot, user
assertuser

Annak ellen?rzese, hogy a jelenlegi felhasznalo a megadott-e.

Tipus: felhasznalo, a kovetkez?k egyikevel megadva: felhasznalonev es Ideiglenes felhasznalo
requestid

Az itt megadott barmilyen ertek szerepelni fog a valaszban. Tobb keres megkulonboztetesere hasznalhato.

servedby

Tartalmazza a valasz kerest kiszolgalo gep nevet.

Tipus: logikai ( reszletek )
curtimestamp

Tartalmazza a valasz az aktualis id?belyeget.

Tipus: logikai ( reszletek )
responselanginfo

A valasz tartalmazza uselang es errorlang parameterekben hasznalt nyelveket.

Tipus: logikai ( reszletek )
origin

When accessing the API using a cross-domain AJAX request (CORS), set this to the originating domain. This must be included in any pre-flight request, and therefore must be part of the request URI (not the POST body).

For authenticated requests, this must match one of the origins in the Origin header exactly, so it has to be set to something like https://en.wikipedia.org or https://meta.wikimedia.org . If this parameter does not match the Origin header, a 403 response will be returned. If this parameter matches the Origin header and the origin is allowed, the Access-Control-Allow-Origin and Access-Control-Allow-Credentials headers will be set.

For non-authenticated requests, specify the value * . This will cause the Access-Control-Allow-Origin header to be set, but Access-Control-Allow-Credentials will be false and all user-specific data will be restricted.

uselang

Az uzenetforditasokhoz hasznalando nyelv. A action=query&meta=siteinfo a siprop=languages parameterrel visszaadja a lehetseges nyelvkodok listajat, vagy user az aktualis felhasznalo, illetve content a wiki nyelvbeallitasahoz.

Alapertelmezett: user
variant

Variant of the language. Only works if the base language supports variant conversion.

errorformat

A figyelmeztetesek es hibauzenetek formatuma

plaintext
Wikiszoveg eltavolitott HTML-cimkekkel es a HTML-entitasok (pl. &amp;) kicserelesevel.
wikitext
Feldolgozatlan wikiszoveg.
html
HTML
raw
Az uzenet azonositoja es parameterei.
none
Szoveges kimenet mell?zese, csak hibakodok.
bc
A MediaWiki 1.29 el?tti formatum. A errorlang es erroruselocal parameterek figyelmen kivul lesznek hagyva.
A kovetkez? ertekek egyike: bc, html, none, plaintext, raw, wikitext
Alapertelmezett: bc
errorlang

A figyelmeztetesekhez es hibauzenetekhez hasznalando nyelv. A action=query&meta=siteinfo a siprop=languages parameterrel visszaadja a lehetseges nyelvkodok listajat, vagy content a wiki nyelvbeallitasahoz, illetve uselang a uselang parameter ertekehez.

Alapertelmezett: uselang
errorsuselocal

Ha meg van adva, a hibauzenetek a helyileg testreszabott uzeneteket fogjak hasznalni a MediaWiki nevterb?l.

Tipus: logikai ( reszletek )
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 10 seconds. This should be included in any pre-flight request, and therefore should be included in the request URI (not the POST body).

Jogosultsagok:
writeapi
a szerkeszt?-API hasznalata
Megadva a kovetkez? csoportoknak: all, user es bot
apihighlimits
Magasabb limitek hasznalata API-lekerdezesekben (lassu lekerdezesek: 500, gyors lekerdezesek: 5000). A lassu lekerdezesek limitje a tobb ertek? parameterekre is vonatkozik.
Megadva a kovetkez? csoportoknak: bot es sysop

Adattipusok

Input to MediaWiki should be NFC-normalized UTF-8. MediaWiki may attempt to convert other input, but this may cause some operations (such as edits with MD5 checks) to fail.

Parameters that take multiple values are normally submitted with the values separated using the pipe character, e.g. param=value1|value2 or param=value1%7Cvalue2 . If a value must contain the pipe character, use U+001F (Unit Separator) as the separator and prefix the value with U+001F, e.g. param=%1Fvalue1%1Fvalue2 .

Some parameter types in API requests need further explanation:

boolean

A logikai parameterek a HTML jelol?negyzeteihez hasonloan m?kodnek: ha a parameter meg van adva, az igazat jelent, fuggetlenul a parameter erteket?l. Hamis ertekhez hagyd el a parametert teljesen.

expiry

Expiry values may be relative (e.g. 5 months or 2 weeks ) or absolute (e.g. 2014-09-18T12:34:56Z ). For no expiry, use infinite , indefinite , infinity or never .

timestamp

Timestamps may be specified in several formats, see the Timestamp library input formats documented on mediawiki.org for details. ISO 8601 date and time is recommended: 2001 - 01 - 15 T 14 : 56 : 00 Z . Additionally, the string now may be used to specify the current timestamp.

Templated parameters

Templated parameters support cases where an API module needs a value for each value of some other parameter. For example, if there were an API module to request fruit, it might have a parameter fruits to specify which fruits are being requested and a templated parameter {fruit}-quantity to specify how many of each fruit to request. An API client that wants 1 apple, 5 bananas, and 20 strawberries could then make a request like fruits=apples|bananas|strawberries&apples-quantity=1&bananas-quantity=5&strawberries-quantity=20 .

Keszit?k

API-fejleszt?k:

  • Jurij Asztrahan (keszit?, vezet? fejleszt? 2006 szeptemberet?l 2007 szeptembereig)
  • Roan Kattouw (vezet? fejleszt? 2007 szeptemberet?l 2009-ig)
  • Viktor Vasziljev
  • Bryan Tong Minh
  • Sam Reed
  • Brad Jorsch (vezet? fejleszt? 2013-tol 2020-ig)

A megjegyzeseidet, javaslataidat es kerdeseidet a mediawiki-api@lists.wikimedia.org cimre kuldheted, vagy keszithetsz egy hibajelentest a https://phabricator.wikimedia.org/ oldalon.