Nápověda k MediaWiki API
Toto je automaticky generovaná dokumentační stránka k MediaWiki API.
Dokumentace a příklady: https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page
Všeobecné informácie
Stav: Všechny funkce uvedené na této stránce by měly fungovat, ale API se stále aktivně vyvíjí a může se kdykoli změnit. Upozornění na změny získáte přihlášením se k e-mailové konferenci mediawiki-api-announce.
Chybné požadavky: Pokud jsou do API zaslány chybné požadavky, bude vrácena HTTP hlavička s klíčem „MediaWiki-API-Error“ a hodnota této hlavičky a chybový kód budou nastaveny na stejnou hodnotu. Více informací najdete v dokumentaci.
Testování: Pro jednoduché testování požadavků na API zkuste Special:ApiSandbox.
Metódy požiadaviek
Požiadavky Action API môžu používať metódy GET a POST. Uprednostňujte metódu GET, ktorá umožňuje smerovať požiadavky na rýchlejšie replikačné servery a ukladať odpovede do vyrovnávacej pamäte, pokiaľ by dĺžka URL s parametrami neprekročila jej limit (bežne 8000 bajtov) alebo modul neprijíma iba požiadavky POST.
Parametre požiadaviek POST sa môžu posielať v dotazovej časti URL požiadavky (ako pri požiadavkách GET) aj v tele požiadavky POST a miešanie oboch spôsobov v jednej požiadavke je povolené. Určité parametre, ako napríklad heslá, sa musia posielať v tele požiadavky. Ak sa rovnaký parameter pošle ako súčasť URL aj v tele požiadavky, musí mať na oboch miestach rovnakú hodnotu.
Datové typy
Vstup do MediaWiki by mal byť NFC-normalizované UTF-8. MediaWiki sa môže pokúsiť konvertovať iný vstup, ale môže to spôsobiť zlyhanie niektorých operácií (napríklad úprav s kontrolami MD5).
Parametre, ktoré prijímajú viacero hodnôt, sa bežne posielajú s hodnotami oddelenými znakom zvislej čiary, napr. param=value1|value2 alebo param=value1%7Cvalue2. Ak hodnota musí obsahovať znak zvislej čiary, použite ako oddeľovač U+001F (Unit Separator) a pred hodnotu vložte U+001F, napr. param=%1Fvalue1%1Fvalue2.
Niektoré typy parametrov v požiadavkách API vyžadujú ďalšie vysvetlenie:
- boolean
Logické (boolean) parametre fungujú ako HTML zaškrtávacie polia: ak je parameter zadaný, bez ohľadu na hodnotu sa považuje za pravdivý (true). Pre hodnotu nepravda (false) parameter úplne vynechajte.
- expiry
Hodnoty vypršania môžu byť relatívne (napr. 5 months alebo 2 weeks) alebo absolútne (napr. 2014-09-18T12:34:56Z). Ak vypršanie nemá nastať, použite infinite, indefinite, infinity alebo never.
- timestamp
Časové pečiatky možno zadať v niekoľkých formátoch, podrobnosti nájdete vo vstupných formátoch knižnice Timestamp zdokumentovaných na mediawiki.org. Odporúča sa dátum a čas podľa ISO 8601: 2001-01-15T14:56:00Z. Na zadanie aktuálneho času možno použiť reťazec now.
Limity
Väčšina modulov API môže prijať až 50 vstupov v parametroch s viacerými hodnotami a môže vrátiť až 500 výsledkov na jeden dotaz (50 výsledkov pre pomalé dotazy).
Pre používateľov s právom apihighlimits (Roboti a Správci) sa limity zvyšujú na 500 vstupov a 5 000 výsledkov (500 výsledkov pre pomalé dotazy).
Šablonované parametry
Šablonované parametry umožňují situace, kdy modul API potřebuje hodnotu pro každou hodnotu nějakého jiného parametru. Pokud by například existoval modul API pro získání ovoce, mohl by mít parametr ovoce, kterým se určí požadované druhy ovoce, a šablonovaný parametr {ovoce}-počet, kterým se určí požadované počty jednotlivých druhů. Klient API, který by chtěl 1 jablko, 5 banánů a 20 jahod, by mohl vytvořit požadavek ovoce=jablka|banány|jahody&jablka-počet=1&banány-počet=5&jahody-počet=20.
Hlavní modul
- Zdroj: MediaWiki
- Licence: GPL-2.0-or-later
Specify the action to perform, the format of the response, and options that apply to all API modules.
- action
Která akce se má provést.
- abusefiltercheckmatch
- Check to see if an AbuseFilter matches a set of variables, an edit, or a logged AbuseFilter event.
- abusefilterchecksyntax
- Zkontroluje syntaxi filtru zneužití.
- abusefilterevalexpression
- Vyhodnotí výraz filtru zneužití.
- abusefilterunblockautopromote
- Unblocks a user from receiving autopromotions due to an abusefilter consequence.
- abuselogprivatedetails
- Zobrazit tajné detaily záznamu v protokolu zneužití
- 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.
- antispoof
- Skontrolovať používateľské meno normalizačnými kontrolami rozšírenia AntiSpoof.
- block
- Zablokovat uživatele.
- 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
- 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
hasmsgpre aktuálneho používateľa. - clientlogin
- Prihlásiť sa na wiki pomocou interaktívneho postupu.
- communityconfigurationedit
- Change the content of a configuration provider in Community configuration
- compare
- Vrátí rozdíl dvou stránek.
- createaccount
- Vytvořit nový uživatelský účet.
- createlocalaccount
- Forcibly create a local account. The central account must exist.
- delete
- Smazat stránku.
- deleteglobalaccount
- Delete a global user.
- discussiontoolsedit
- Zveřejnit zprávu na diskusní stránce.
- discussiontoolsfindcomment
- Find a comment by its ID or name.
- discussiontoolsgetsubscriptions
- Získat stavy odběru daných témat.
- discussiontoolssubscribe
- Přihlášení (nebo odhlášení) příjmu oznámení o tématu.
- 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
- Vytvářet a upravovat stránky.
- editmassmessagelist
- Edit a mass message delivery list.
- emailuser
- Poslat uživateli e-mail.
- expandtemplates
- Rozbalí všechny šablony ve wikitextu.
- featuredfeed
- Vráti kanál odporúčaného obsahu.
- 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.
- 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
- Zobrazuje nápovědu k uvedeným modulům.
- imagerotate
- Tento modul byl deaktivován.
- import
- Importovať stránku z inej wiki alebo z XML súboru.
- jsonconfig
- Allows direct access to JsonConfig subsystem.
- 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.
- massmessage
- Send a message to a list of pages.
- 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).
- setglobalaccountstatus
- Nastavit stav globálního účtu
- setnotificationtimestamp
- Aktualizovať časovú pečiatku upozornení pre sledované stránky.
- setpagelanguage
- Zmeniť jazyk stránky.
- shortenurl
- Zkrátit dlouhé URL na kratší.
- sitematrix
- Získať zoznam stránok Wikimedia.
- spamblacklist
- Overiť jednu alebo viac URL voči zoznamu blokovaných spamových adries.
- streamconfigs
- Sprístupňuje konfiguráciu prúdov udalostí. Vracia iba format=json s formatversion=2.
- strikevote
- Allows admins to strike or unstrike a vote.
- tag
- Pridávať alebo odstraňovať značky zmien z jednotlivých revízií alebo položiek záznamov.
- templatedata
- Získať údaje uložené rozšírením TemplateData.
- thank
- Odoslať redaktorovi upozornenie s poďakovaním.
- titleblacklist
- Ověřit název stránky, název souboru nebo uživatelské jméno vůči černé listině názvů.
- torblock
- Skontrolovať, či je IP adresa zablokovaná ako výstupný uzol siete Tor.
- transcodereset
- Users with the 'transcode-reset' right can reset and re-run a transcode job.
- 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.
- webapp-manifest
- Vráti manifest webovej aplikácie.
- webauthn
- API Module to communicate between server and client during registration/authentication process.
- bouncehandler
- Interné. Prijať vrátený e-mail a spracovať ho, aby sa vyriešil zlyhávajúci príjemca.
- categorytree
- Interné. Interný modul rozšírenia CategoryTree.
- chartinfo
- Interné. 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
- Interné. Reports on the correctness of a range of page ids in the search index
- cirrus-config-dump
- Interné. Dump of CirrusSearch configuration.
- cirrus-profiles-dump
- Interné. Dump of CirrusSearch profiles for this wiki.
- cirrus-schema-dump
- Interné. Dump of CirrusSearch schema (settings and mappings) for this wiki.
- codemirror-validate
- Interné. Skontrolovať chyby overenia v zadanom obsahu
- collection
- Interné. API module for performing various operations on a wiki user's collection.
- 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.
- discussiontoolscompare
- Interné. Získat informace o změnách komentářů mezi dvěma revizemi stránky.
- discussiontoolspageinfo
- Interné. Vrací metadata potřebná k inicializaci Diskusních nástrojů.
- discussiontoolspreview
- Interné. Náhled zprávy na stránce diskuse.
- editcheckreferenceurl
- Interné. Check the status of a URL for use as a reference.
- fancycaptchareload
- Interné. Získať nový FancyCaptcha.
- jsondata
- Interné. Retrieve localized JSON data.
- jsontransform
- Interné. Retrieve JSON data transformed by a Lua function.
- parser-migration
- Interné. Analyzuje stránku pomocí dvou odlišných konfigurací Tidy.
- readinglists
- Interné. Reading list write operations.
- sanitize-mapdata
- Interné. Performs data validation for Kartographer extension
- scribunto-console
- Interné. Interný modul na obsluhu XHR požiadaviek z konzoly rozšírenia Scribunto.
- securepollauth
- Interné. Allows a remote wiki to authenticate users before granting access to vote in the election.
- stashedit
- Interné. Pripraviť úpravu v zdieľanej vyrovnávacej pamäti.
- timedtext
- Interné. Provides timed text content for usage by <track> elements
- ulslocalization
- Interné. Získať lokalizáciu ULS v zadanom jazyku.
- ulssetlang
- Interné. Aktualizovať používateľom preferovaný jazyk rozhrania.
- visualeditor
- Interné. Returns HTML5 for a page from the Parsoid service.
- visualeditoredit
- Interné. Save an HTML5 page to MediaWiki (converted to wikitext via the Parsoid service).
- wikimediaeventsblockededit
- Interné. Log information about blocked edit attempts
- wikimediaeventshcaptchaeditattempt
- Interné. Log edit diff when hCaptcha challenge is shown but edit is incomplete
- Jedna z následujících hodnot: 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, 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, wikimediaeventsblockededit, wikimediaeventshcaptchaeditattempt
- Predvolené: help
- format
Formát výstupu.
- Jedna z následujících hodnot: json, jsonfm, none, rawfm, xml, xmlfm
- Predvolené: jsonfm
- maxlag
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.- Typ: celé číslo
- smaxage
Nastaví HTTP hlavičku pro řízení kešování
s-maxagena uvedený počet sekund. Chyby se nekešují nikdy.- Typ: celé číslo
- Hodnota nesmie byť menšia ako 0.
- Predvolené: 0
- maxage
Nastaví HTTP hlavičku pro řízení kešování
max-agena uvedený počet sekund. Chyby se nekešují nikdy.- Typ: celé číslo
- Hodnota nesmie byť menšia ako 0.
- Predvolené: 0
- assert
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“.
- Jedna z následujících hodnot: anon, bot, user
- assertuser
Ověřit, že současným uživatelem je uvedený uživatel.
- Typ: uživatel, uvedený jako cokoli z: uživatelské jméno a Dočasný uživatel
- requestid
Libovolná zde uvedená hodnota bude zahrnuta v odpovědi. Lze použít pro rozlišení požadavků.
- servedby
Zahrnout do odpovědi název hostitele, který požadavek obsloužil.
- Typ: logická hodnota (boolean) (podrobnosti)
- curtimestamp
Zahrnout do odpovědi aktuální časové razítko.
- Typ: logická hodnota (boolean) (podrobnosti)
- responselanginfo
Zahrnúť do výsledku jazyky použité pre uselang a errorlang.
- Typ: logická hodnota (boolean) (podrobnosti)
- origin
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čceOrigin, bude vrácena odpověď 403. Pokud parametr odpovídá hlavičceOrigina tento původ je na bílé listině, budou nastaveny hlavičkyAccess-Control-Allow-OriginaAccess-Control-Allow-Credentials.U neautentizovaných požadavků uveďte hodnotu *. To způsobí nastavení hlavičky
Access-Control-Allow-Origin, ale hlavičkaAccess-Control-Allow-Credentialsbudefalsea budou omezena všechna data specifická pro uživatele.- crossorigin
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.
- Typ: logická hodnota (boolean) (podrobnosti)
- uselang
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.
- Predvolené: user
- variant
Variant jazyka. Funguje len vtedy, ak základný jazyk podporuje konverziu variantov.
- errorformat
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ú.
- Jedna z následujících hodnot: bc, html, none, plaintext, raw, wikitext
- Predvolené: bc
- errorlang
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.
- Predvolené: uselang
- errorsuselocal
Ak je zadané, chybové texty budú používať lokálne prispôsobené správy z menného priestoru MediaWiki.
- Typ: logická hodnota (boolean) (podrobnosti)
- centralauthtoken
Tento token používejte při přístupu k API pomocí mezidoménového AJAX požadavku (CORS) pro autentizaci jako aktuální uživatel SUL. Před provedením CORS requestu získejte na této wiki token pomocí action=centralauthtoken. Každý token lze použít pouze jednou a expiruje po 10 sekundách. Měl by se použít v případném předběžném požadavku, takže by se měl objevit v URI požadavku (nikoli tělu POST).
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.
- Nápověda k hlavnímu modulu
- api.php?action=help [otevřít v pískovišti]
- Veškerá nápověda na jedné stránce
- api.php?action=help&recursivesubmodules=1&toc [otevřít v pískovišti]
Zásluhy
Vývojáři API:
- Jurij Astrachan (tvůrce, hlavní vývojář září 2006 – září 2007)
- Roan Kattouw (hlavní vývojář září 2007–2009)
- Viktor Vasiljev
- Bryan Tong Minh
- Sam Reed
- Brad Jorsch (hlavní vývojář 2013–2020)
Své komentáře, návrhy či dotazy posílejte na mediawiki-api@lists.wikimedia.org nebo založte chybové hlášení na https://phabricator.wikimedia.org/.