MediaWiki API help

This is an auto-generated MediaWiki API documentation page.

Documentation and examples: https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page

Main module

Status: The MediaWiki API is a mature and stable interface that is actively supported and improved. While we try to avoid it, we may occasionally need to make breaking changes; subscribe to the mediawiki-api-announce mailing list for notice of updates.

Erroneous requests: When erroneous requests are sent to the API, an HTTP header will be sent with the key "MediaWiki-API-Error" and then both the value of the header and the error code sent back will be set to the same value. For more information see API: Errors and warnings .

Specifi?ni parametri:
action

Katero dejanje izvesti.

abusefiltercheckmatch
Preveri, ali se AbuseFilter ujema z naborom spremenljivk, urejanjem ali zabele?enim dogodkom AbuseFilter.
abusefilterchecksyntax
Preveri skladnjo filtra AbuseFilter.
abusefilterevalexpression
Oceni izraz filtra AbuseFilter.
abusefilterunblockautopromote
Odblokira uporabnika, da ne bi zaradi filtra AbuseFilter prejemal samodejnih napredovanj.
abuselogprivatedetails
Prika?e zasebne podatke zapisa filtra dnevnika zlorab.
acquiretempusername
Pridobite za?asno uporabni?ko ime in ga shranite v trenutno sejo, ?e je omogo?eno ustvarjanje za?asnega ra?una in je trenutni uporabnik odjavljen. ?e je bilo ime ?e shranjeno, vrne isto ime.
antispoof
Preverite uporabni?ko ime glede na normalizacijsko preverjanje AntiSpoof.
block
Block a user.
centralauthtoken
Pridobi centralni avtentifikacijski ?eton za avtentificirano zahtevo za prilo?eni viki.
centralnoticecdncacheupdatebanner
Zahtevek za po?i??enje vsebine oglasne pasice, shranjene v predpomnilniku CDN (front-end) za anonimne uporabnike, za zahtevano oglasno pasico in jezik.
centralnoticechoicedata
Pridobi podatke, potrebne za izbiro pasice za dolo?en projekt in jezik
centralnoticequerycampaign
Pridobi vse konfiguracijske nastavitve za kampanjo.
changeauthenticationdata
Change authentication data for the current user.
changecontentmodel
Change the content model of a page
checktoken
Check the validity of a token from action=query&meta=tokens .
cirrus-config-dump
Izpis konfiguracije CirrusSearch.
cirrus-mapping-dump
Izpis preslikave CirrusSearch za ta viki.
cirrus-profiles-dump
Izpis profilov CirrusSearch za ta viki.
cirrus-settings-dump
Izpis nastavitev CirrusSearch za ta viki.
clearhasmsg
Clears the hasmsg flag for the current user.
clientlogin
Log in to the wiki using the interactive flow.
compare
Get the difference between two pages.
createaccount
Create a new user account.
createlocalaccount
Prisilno ustvari lokalni ra?un. Obstajati mora centralni ra?un.
cxdelete
Izbri?ite osnutek prevoda, ki je bil ustvarjen z Wikiprevajalnikom.
cxsuggestionlist
Upravljaj seznam predlogov. Predloge lahko dodaja? ali odstranjuje? s seznama.
cxtoken
Pridobi ?etone JWT za avtentikacijo s cxserver.
delete
Izbri?e stran.
deleteglobalaccount
Izbri?i globalnega uporabnika.
discussiontoolsedit
Objava sporo?ila na razpravni strani.
discussiontoolsfindcomment
Iskanje komentarja po ID-ju ali imenu.
discussiontoolsgetsubscriptions
Pridobi stanja naro?enosti na predlo?ene teme.
discussiontoolssubscribe
Naro?i (ali odnaro?i) prejemanje obvestil o temi.
echocreateevent
Ro?na spro?itev obvestila uporabnika
echomarkread
Ozna?i obvestila kot prebrana za trenutnega uporabnika.
echomarkseen
Ozna?i obvestila kot ogledana za trenutnega uporabnika.
echomute
Izklop ali vklop obvestil dolo?enih uporabnikov ali strani
edit
Ustvarjanje in urejanje strani.
editmassmessagelist
Urejanje seznama za po?iljanje mno?i?nega sporo?ila.
emailuser
Email a user.
expandtemplates
Raz?iri vse predloge v vikibesedilu.
featuredfeed
Vrne vir izbrane vsebine.
feedcontributions
Returns a user's contributions feed.
feedrecentchanges
Vrne vir zadnjih sprememb
feedwatchlist
Vrne vir spiska nadzorov.
filerevert
Revert a file to an old version.
globalblock
Globalno blokirajte ali odblokirajte uporabnika.
globalpreferenceoverrides
Spremeni lokalne prepise za globalne nastavitve trenutnega uporabnika.
globalpreferences
Spremeni globalne nastavitve trenutnega uporabnika.
globaluserrights
Dodaj/odstrani uporabnika k/iz globalne skupine.
growthmanagementorlist
Upravljajte informacij na strukturiranem seznamu mentorjev (obi?ajno shranjenem v MediaWiki:GrowthMentors.json ). Ta modul lahko uporabljajo tako sedanji kot bodo?i mentorji (da se dodajo ali spremenijo svoje podatke) in administratorji (za vse uporabnike).
growthmentordashboardupdatedata
Dolo?ite ?as za izredno posodobitev modula za pregled mentorirancev na nadzorni plo??i mentorja. Zaradi zmogljivosti lahko dolo?ite samo eno posodobitev na dve uri.
growthsetmenteestatus
Nastavitev stanja mentoriranca (omogo?a mentorirancu, da omogo?i/onemogo?i modul mentorstva ali da se popolnoma odjavi, kar izbri?e odnos mentoriranec/mentor)
growthsetmentor
Dolo?i uporabnikovega mentorja. Sprememba se bo javno zabele?ila.
growthstarmentee
Ozna?i ali odzna?i mentoriranca_ko kot z zvezdico za trenutnega uporabnika_co (shranjeno zasebno in se ne zapi?e v dnevnik)
help
Display help for the specified modules.
homepagequestionstore
Prodibi oblikovana vpra?anja, objavljena prek modulov doma?e strani
imagerotate
This module has been disabled.
import
Import a page from another wiki, or from an XML file.
jsonconfig
Omogo?a neposreden dostop do podsistema JsonConfig.
languagesearch
Poi??e imena jezikov v kateri koli pisavi.
linkaccount
Link an account from a third-party provider to the current user.
login
Log in and get authentication cookies.
logout
Log out and clear session data.
managetags
Perform management tasks relating to change tags.
massmessage
Po?lje sporo?ilo na seznam strani.
mergehistory
Merge page histories.
move
Prestavi stran.
opensearch
Search the wiki using the OpenSearch protocol.
options
Change preferences of the current user.
paraminfo
Obtain information about API modules.
parse
Parses content and returns parser output.
patrol
Patrol a page or revision.
protect
Change the protection level of a page.
purge
Po?isti predpomnilnik za dane naslove.
query
Pridobi podatke MediaWikija in o MediaWikiju.
removeauthenticationdata
Remove authentication data for the current user.
resetpassword
Send a password reset email to a user.
revisiondelete
Izbri?e in odizbri?e redakcije.
rollback
Undo the last edit to the page.
rsd
Export an RSD (Really Simple Discovery) schema.
setglobalaccountstatus
Skrij ali zakleni (ali razkrij ali odkleni) globalni uporabni?ki ra?un
setnotificationtimestamp
Update the notification timestamp for watched pages.
setpagelanguage
Change the language of a page.
shortenurl
Skraj?a dolg URL v kraj?ega.
sitematrix
Pridobite seznam spletnih mest Wikipedije.
spamblacklist
Preveri enega ali ve? URL-jev na seznamu blokiranja smetja.
streamconfigs
Izpostavi konfiguracijo toka dogodkov. Vrne samo format=json s formatversion=2.
strikevote
Administratorjem omogo?a, da izlo?ijo ali sprejmejo glas.
sxdelete
Izbri?i osnutek prevoda razdelka in njegove vzporedne korpuse iz podatkovne zbirke.
tag
Add or remove change tags from individual revisions or log entries.
templatedata
Pridobi podatke, ki jih shranjuje raz?iritev TemplateData.
thank
Po?lje obvestilo o zahvali urejevalcu.
titleblacklist
Validiranje naslova strani, imena datoteke ali uporabni?kega imena glede na TitleBlacklist.
torblock
Preveri, ali je IP-naslov blokiran kot izhodno vozli??e Tor.
transcodereset
Uporabniki s pravico ≫transcode-reset≪ lahko ponastavijo in znova za?enejo opravilo prekodiranja.
unblock
Unblock a user.
undelete
Odizbris redakcij izbrisane strani.
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
Dodatek ali odstranitev strani s spiska nadzora
webapp-manifest
Vrne manifest ≫webapp≪.
webauthn
API-modul za komunikacijo med stre?nikom in odjemalcem v postopku registracije/avtentikacije.
wikilove
Podarite drugemu uporabniku WikiLjubezen.
bouncehandler
Internal. Prejme zavrnjeno e-po?tno sporo?ilo in ga obdela za obravnavo neuspe?nega prejemnika.
categorytree
Internal. Notranji modul za raz?iritev CategoryTree.
cirrus-check-sanity
Internal. Reports on the correctness of a range of page ids in the search index
collection
Internal. API-modul za izvajaje razli?nih operacij v uporabnikovi wikizbirki.
cspreport
Internal. 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
Internal. Check if any fast, unreviewed translation has been published recently for the current user.
cxpublish
Internal. Shranite stran, ki je bila ustvarjena z Wikiprevajalnikom.
cxpublishsection
Internal. Shrani razdelek, ustvarjeno z mo?nostjo prevajanja po razdelkih prevajalnika Content Translation.
cxsave
Internal. Ta modul omogo?a shranjevanje osnutkov prevodov po razdelkih, da se prihrani pasovna ?irina in ustvari vzporedni korpus.
cxsplit
Internal. Ustvaritev in shranitev prevoda razdelka v zbirko podatkov za vsak prevedeni del danega prevoda ?lanka
discussiontoolscompare
Internal. Pridobi informacije o spremembah komentarjev med dvema redakcijama strani.
discussiontoolspageinfo
Internal. Vrne metapodatke, potrebne za inicializacijo orodij za razprave.
discussiontoolspreview
Internal. Predogled sporo?ila na razpravni strani.
echopushsubscriptions
Internal. Upravljanje potisnih naro?il za trenutnega uporabnika.
editcheckreferenceurl
Internal. Check the status of a URL for use as a reference.
fancycaptchareload
Internal. Pridobi nov FancyCaptcha.
growthinvalidateimagerecommendation
Internal. Razveljavi priporo?ilo slike.
growthinvalidatepersonalizedpraisesuggestion
Internal. Razveljavi predlog za hvalevrednega mentoriranca v modulu Personalizirana pohvala na mentorski nadzorni plo??i
helppanelquestionposter
Internal. Obdeluje vpra?anja, objavljena na panelu pomo?i aktualnega uporabnika.
jsondata
Internal. Pridobi lokalizirane podatke JSON.
oathvalidate
Internal. Preveri ?eton dvofaktorske avtentikacije (OATH).
parser-migration
Internal. Raz?leni stran z dvegma razli?nima konfiguracijama raz?lenjevalnika.
readinglists
Internal. Operacije zapisovanja bralnih seznamov.
sanitize-mapdata
Internal. Izvaja validacijo podatkov za raz?iritev Kartographer
scribunto-console
Internal. Notranji modul za stre?bo zahtevkov XHR iz konzole Scribunto.
securepollauth
Internal. Omogo?a oddaljenemu vikiju avtentikacijo uporabnikov pred odobritvijo dostopa do glasovanja na volitvah.
stashedit
Internal. Prepare an edit in shared cache.
sxsave
Internal. Shrani osnutek prevoda razdelka in shrani vzporedni korpus.
timedtext
Internal. Zagotovi ?asovno razporejeno vsebino za uporabo z elementi <track>
ulslocalization
Internal. Pridobi lokalizacijo ULS v predlo?enem jeziku.
ulssetlang
Internal. Posodobite ?eleni jezik uporabni?kega vmesnika.
visualeditor
Internal. Vrne HTML5 za stran iz storitve Parsoid.
visualeditoredit
Internal. Shrani stran HTML5 v MediaWiki (s storitvijo Parsoid pretvorjeno v vikibesedilo).
wikimediaeventsblockededit
Internal. Bele?enje podatkov o poskusih blokiranega urejanja
One of the following values: 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 , feedwatchlist , filerevert , 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 , revisiondelete , rollback , rsd , setglobalaccountstatus , setnotificationtimestamp , setpagelanguage , shortenurl , sitematrix , spamblacklist , streamconfigs , strikevote , sxdelete , tag , templatedata , thank , 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
Privzeto: help
format

Oblika izhoda.

json
Izhodni podatki v formatu JSON.
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
Izhodni podatki v formatu XML.
xmlfm
Output data in XML format (pretty-print in HTML).
One of the following values: json , jsonfm , none , php , phpfm , rawfm , xml , xmlfm
Privzeto: jsonfm
maxlag

Najve?ja zakasnitev se lahko uporabi, ?e je MediaWiki name??en v gru?i z replicirano podatkovno zbirko. ?e ?elite prihraniti dejanja, ki bi povzro?ila ve?jo zakasnitev replikacije spletnega mesta, lahko s tem parametrom odjemalec po?aka, da je zakasnitev replikacije manj?a od dolo?ene vrednosti. V primeru prevelike zakasnitve se vrne koda napake maxlag s sporo?ilom, kot je Waiting for $host: $lag seconds lagged .
Za ve? informacij glejte Manual: Maxlag parameter .

Vtipkajte: celo ?tevilo
smaxage

Nastavite kontrolno glavo s-maxage predpomnenja HTTP na to ?tevilo sekund. Napake se nikoli ne predpomnijo.

Vtipkajte: celo ?tevilo
The Vrednost ne sme biti manj?a od 0.
Privzeto: 0
maxage

Nastavite kontrolno glavo max-age predpomnenja HTTP na to ?tevilo sekund. Napake se nikoli ne predpomnijo.

Vtipkajte: celo ?tevilo
The Vrednost ne sme biti manj?a od 0.
Privzeto: 0
assert

Preveri, da je uporabnik prijavljen (vklju?no z morebitno za?asno prijavo), ?e je nastavljeno na user , da ni prijavljen, ?e je nastavljeno na anon , in da ima uporabni?ko pravico bota, ?e je nastavljeno na bot .

One of the following values: anon, bot, user
assertuser

Preveri, ali je trenutni uporabnik poimenovani uporabnik.

Vrsta: uporabnik, ki ustreza kateremu koli od uporabni?ko ime in Za?asen uporabnik
requestid

V odgovor bo vklju?ena vsaka tu navedena vrednost. Lahko se uporablja za razlo?evanje zahtevkov.

servedby

V rezultate vklju?i ime gostitelja, ki je posredoval zahtevek.

Type: boolean ( details )
curtimestamp

V rezultat vklju?i trenutni ?asovni ?ig.

Type: boolean ( details )
responselanginfo

V rezultat vklju?i jezike, ki se uporabljajo za uselang in errorlang .

Type: boolean ( details )
origin

?e do API-ja dostopate z meddomensko zahtevo AJAX (CORS), to nastavite na domeno izvora. To mora biti vklju?eno v vsak predpoletni zahtevek, zato mora biti del URI-ja zahtevka (in ne telesa POST).

Pri avtenticiranih zahtevkih se mora to natan?no ujemati z enim od izvorov v glavi Origin, zato je to treba nastaviti na nekaj takega kot https://en.wikipedia.org ali https://meta.wikimedia.org . ?e se ta parameter ne ujema z glavo Origin , bo vrnjen odgovor 403. ?e se ta parameter ujema z glavo Origin in je izvor dovoljen, bosta nastavljeni glavi Access-Control-Allow-Origin in Access-Control-Allow-Credentials .

Za neavtenticirane zahtevke dolo?ite vrednost * . To bo povzro?ilo, da bo nastavljena glava Access-Control-Allow-Origin , vendar bo Access-Control-Allow-Credentials false in bodo vsi podatki, specifi?ni za uporabnika, omejeni.

uselang

Jezik, ki se uporablja za prevajanje sporo?il. action=query&meta=siteinfo s siprop=languages vrne seznam jezikovnih kod ali dolo?i user za uporabo jezikovne preference trenutnega uporabnika ali dolo?i content za uporabo jezika vsebine tega vikija.

Privzeto: user
variant

Razli?ica jezika. Deluje le, ?e osnovni jezik podpira pretvorbo variant.

errorformat

Oblika, ki se uporablja za izpis besedila o opozorilih in napakah

plaintext
Wikitext with HTML tags removed and entities replaced.
wikitext
Neraz?lenjeno vikibesedilo.
html
HTML
raw
Message key and parameters.
none
No text output, only the error codes.
bc
Format used prior to MediaWiki 1.29. errorlang and errorsuselocal are ignored.
One of the following values: bc, html, none, plaintext, raw, wikitext
Privzeto: bc
errorlang

Jezik, ki se uporablja za opozorila in napake. Dolo?ite eno od jezikovnih kod, ki jih vrne action=query&meta=siteinfo s siprop=languages ali pa dolo?ite content za uporabo jezika vsebine tega vikija ali uselang za uporabo iste vrednosti kot parameter uselang (preferen?ni jezik uporabnika).

Privzeto: uselang
errorsuselocal

?e je podano, bodo besedila o napakah uporabljala lokalno prilagojena sporo?ila iz imenskega prostora MediaWiki.

Type: boolean ( details )
centralauthtoken

?e do API-ja dostopate z meddomensko zahtevo AJAX (CORS), to uporabite za avtentikacijo kot trenutni uporabnik SUL. Za pridobitev ?etona uporabite action=centralauthtoken v tem vikiju, preden izvedete zahtevek CORS. Vsak ?eton se lahko uporabi samo enkrat in prete?e po 10 sekundah. To je treba vklju?iti v vsak predpoletni zahtevek, zato mora biti vklju?eno v URI zahtevka (in ne v telo POST).

Permissions:
writeapi
Uporaba API-ja za pisanje
Granted to: all, user in bot
apihighlimits
Use higher limits in API queries (slow queries: 500; fast queries: 5000). The limits for slow queries also apply to multivalue parameters.
Granted to: bot in sysop

Vrste podatkov

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

Boolean parameters work like HTML checkboxes: if the parameter is specified, regardless of value, it is considered true. For a false value, omit the parameter entirely.

expiry

Vrednosti ?asa preteka so lahko relativne (npr. 5 months ali 2 weeks ) ali absolutne (npr. 2014-09-18T12:34:56Z ). ?e ne ?elite dolo?iti ?asa preteka, uporabite infinite , indefinite , infinity ali 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 .

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