Nápověda k MediaWiki API

Která akce se má provést.

acquiretempusername

Získať meno dočasného používateľa a uložiť ho do aktuálnej relácie, ak je povolené vytváranie dočasných účtov a aktuálny používateľ je odhlásený. Ak už bolo nejaké meno uložené, vráti to isté meno.

block

Zablokovat uživatele.

changeauthenticationdata

Zmeniť autentifikačné údaje aktuálneho používateľa.

changecontentmodel

Zmeniť model obsahu stránky

checktoken

Skontrolovať platnosť tokenu z action=query&meta=tokens.

clearhasmsg

Vymaže príznak hasmsg pre aktuálneho používateľa.

clientlogin

Prihlásiť sa na wiki pomocou interaktívneho postupu.

compare

Vrátí rozdíl dvou stránek.

createaccount

Vytvořit nový uživatelský účet.

delete

Smazat stránku.

edit

Vytvářet a upravovat stránky.

emailuser

Poslat uživateli e-mail.

expandtemplates

Rozbalí všechny šablony ve wikitextu.

feedcontributions

Vrátí kanál příspěvků uživatele.

feedrecentchanges

Vráti kanál posledných zmien.

feedwatchlist

Vráti kanál zoznamu sledovaných.

filerevert

Revertovat soubor na starší verzi.

help

Zobrazuje nápovědu k uvedeným modulům.

imagerotate

Otočit jeden nebo více obrázků.

import

Importovať stránku z inej wiki alebo z XML súboru.

languagesearch

Vyhľadávať názvy jazykov v akomkoľvek písme.

linkaccount

Prepojiť účet od poskytovateľa tretej strany s aktuálnym používateľom.

login

Prihlásiť sa a získať autentifikačné cookies.

logout

Odhlásiť sa a vymazať údaje relácie.

managetags

Vykonávať úlohy správy súvisiace so značkami zmien.

mergehistory

Zlúčiť históriu stránok.

move

Přesunout stránku.

opensearch

Vyhledávání na wiki pomocí protokolu OpenSearch.

options

Zmeniť nastavenia aktuálneho používateľa.

paraminfo

Získať informácie o moduloch API.

parse

Parsuje obsah a vráti výstup parsera.

patrol

Strážiť stránku alebo revíziu.

protect

Změnit úroveň zamčení stránky.

purge

Vyprázdniť vyrovnávaciu pamäť pre zadané názvy stránok.

query

Získavať dáta z MediaWiki a o MediaWiki.

removeauthenticationdata

Odstrániť autentifikačné údaje aktuálneho používateľa.

resetpassword

Poslať používateľovi email na obnovenie hesla.

revisiondelete

Vymazávať a obnovovať revízie.

rollback

Vrátiť poslednú úpravu stránky.

rsd

Exportovať schému RSD (Really Simple Discovery).

setnotificationtimestamp

Aktualizovať časovú pečiatku upozornení pre sledované stránky.

setpagelanguage

Zmeniť jazyk stránky.

tag

Pridávať alebo odstraňovať značky zmien z jednotlivých revízií alebo položiek záznamov.

unblock

Odblokovať používateľa.

undelete

Obnoviť revízie vymazanej stránky.

unlinkaccount

Odstrániť prepojený účet tretej strany od aktuálneho používateľa.

upload

Nahrať súbor alebo získať stav čakajúcich nahraní.

userrights

Zmeniť členstvo používateľa v skupinách.

validatepassword

Overiť heslo voči politikám hesiel wiki.

watch

Pridávať alebo odstraňovať stránky zo zoznamu sledovaných aktuálneho používateľa.

cspreport

Interné. Používajú prehliadače na hlásenie porušení pravidiel Content Security Policy. Tento modul by sa nemal nikdy používať, s výnimkou automatického použitia webovým prehliadačom kompatibilným s CSP.

stashedit

Interné. Pripraviť úpravu v zdieľanej vyrovnávacej pamäti.

Formát výstupu.

json

Vypisuje data ve formátu JSON.

jsonfm

Vypisuje data ve formátu JSON (v čitelné HTML podobě).

none

Nevypisuje nic.

php

Vypisuje data v serializačním formátu PHP.

phpfm

Vypisuje data v serializačním formátu PHP (v čitelné HTML podobě).

rawfm

Data včetně ladicích prvků vypisuje ve formátu JSON (v čitelné HTML podobě).

xml

Vypisuje data ve formátu XML.

xmlfm

Vypisuje data ve formátu XML (v čitelné HTML podobě).

Maximální zpoždění lze použít, když je MediaWiki nainstalováno na cluster s replikovanou databází. Abyste se vyhnuli zhoršování už tak špatného replikačního zpoždění, můžete tímto parametrem nechat klienta čekat, dokud replikační zpoždění neklesne pod uvedenou hodnotu. V případě příliš vysokého zpoždění se vrátí chybový kód „maxlag“ s hlášením typu „Waiting for $host: $lag seconds lagged“.
Více informací najdete v příručce.

Nastaví HTTP hlavičku pro řízení kešování s-maxage na uvedený počet sekund. Chyby se nekešují nikdy.

Nastaví HTTP hlavičku pro řízení kešování max-age na uvedený počet sekund. Chyby se nekešují nikdy.

Pokud je nastaveno na „user“, ověří, že je uživatel přihlášen, pokud je nastaveno na „bot“, ověří, že má oprávnění „bot“.

Ověřit, že současným uživatelem je uvedený uživatel.

Libovolná zde uvedená hodnota bude zahrnuta v odpovědi. Lze použít pro rozlišení požadavků.

Zahrnout do odpovědi název hostitele, který požadavek obsloužil.

Zahrnout do odpovědi aktuální časové razítko.

Zahrnúť do výsledku jazyky použité pre uselang a errorlang.

Pokud k API přistupujete pomocí mezidoménového AJAXového požadavku (CORS), nastavte tento parametr na doménu původu. Musí být součástí všech předběžných požadavků, takže musí být součástí URI požadavku (nikoli těla POSTu).

U autentizovaných požadavků hodnota musí přesně odpovídat jednomu z původů v hlavičce Origin, takže musí být nastavena na něco jako https://en.wikipedia.org nebo https://meta.wikimedia.org. Pokud parametr neodpovídá hlavičce Origin, bude vrácena odpověď 403. Pokud parametr odpovídá hlavičce Origin a tento původ je na bílé listině, budou nastaveny hlavičky Access-Control-Allow-Origin a Access-Control-Allow-Credentials.

U neautentizovaných požadavků uveďte hodnotu *. To způsobí nastavení hlavičky Access-Control-Allow-Origin, ale hlavička Access-Control-Allow-Credentials bude false a budou omezena všechna data specifická pro uživatele.

Pri prístupe k API pomocou AJAX požiadavky medzi doménami (CORS) a použití poskytovateľa relácie, ktorý je bezpečný proti útokom CSRF (cross-site request forgery), ako je napríklad OAuth, použite tento parameter namiesto origin=*, aby bola požiadavka autentifikovaná (t. j. nie odhlásená). Musí byť zahrnutý v každej predbežnej (pre-flight) požiadavke, a preto musí byť súčasťou URL požiadavky (nie tela POST).

Upozorňujeme, že väčšina poskytovateľov relácií vrátane štandardných relácií založených na cookies nepodporuje autentifikované CORS a nemožno ich použiť s týmto parametrom.

Jazyk, který se má použít pro překlad hlášení. Pomocí action=query&meta=siteinfo se siprop=languages získáte seznam jazykových kódů nebo zadejte „user“ pro použití předvoleného jazyka aktuálního uživatele či „content“ pro použití jazyka obsahu této wiki.

Variant jazyka. Funguje len vtedy, ak základný jazyk podporuje konverziu variantov.

Formát, ktorý sa má použiť pre textový výstup upozornení a chýb

plaintext

Wikitext s odstránenými HTML značkami a nahradenými entitami.

wikitext

Neparsovaný wikitext.

html

HTML

raw

Kľúč správy a parametre.

none

Žiadny textový výstup, iba chybové kódy.

bc

Formát používaný pred MediaWiki 1.29. errorlang a errorsuselocal sa ignorujú.

Jazyk, ktorý sa má použiť pre upozornenia a chyby. action=query&meta=siteinfo&siprop=languages vráti zoznam kódov jazykov. Zadajte content, aby sa použil jazyk obsahu tejto wiki, alebo uselang, aby sa použila rovnaká hodnota ako v parametri uselang.

Ak je zadané, chybové texty budú používať lokálne prispôsobené správy z menného priestoru MediaWiki.