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/API
Hlavnà modul
- Zdroj: MediaWiki
- Licence: GPL-2.0-or-later
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.
- action
Která akce se má provést.
- block
- Zablokovat uživatele.
- 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.
- clearhasmsg
- Clears the
hasmsgflag for the current user. - clientlogin
- Log in to the wiki using the interactive flow.
- 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
- Returns a recent changes feed.
- feedwatchlist
- Returns a watchlist feed.
- 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
- Import a page from another wiki, or from an XML file.
- 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.
- mergehistory
- Merge page histories.
- move
- PÅesunout stránku.
- opensearch
- Vyhledávánà na wiki pomocà protokolu OpenSearch.
- 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
- ZmÄnit úroveÅ zamÄenà stránky.
- purge
- Purge the cache for the given titles.
- query
- Fetch data from and about MediaWiki.
- removeauthenticationdata
- Remove authentication data for the current user.
- resetpassword
- Send a password reset email to a user.
- revisiondelete
- Delete and undelete revisions.
- rollback
- Undo the last edit to the page.
- rsd
- Export an RSD (Really Simple Discovery) schema.
- setnotificationtimestamp
- Update the notification timestamp for watched pages.
- setpagelanguage
- Change the language of a page.
- tag
- Add or remove change tags from individual revisions or log entries.
- unblock
- Unblock a user.
- undelete
- Restore 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.
- tokens
- Zastaralý. Get tokens for data-modifying actions.
- 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.
- stashedit
- Internal. Prepare an edit in shared cache.
- Jedna z následujÃcÃch hodnot: block, changeauthenticationdata, changecontentmodel, checktoken, clearhasmsg, clientlogin, compare, createaccount, delete, edit, emailuser, expandtemplates, feedcontributions, feedrecentchanges, feedwatchlist, filerevert, help, imagerotate, import, linkaccount, login, logout, managetags, mergehistory, move, opensearch, options, paraminfo, parse, patrol, protect, purge, query, removeauthenticationdata, resetpassword, revisiondelete, rollback, rsd, setnotificationtimestamp, setpagelanguage, tag, unblock, undelete, unlinkaccount, upload, userrights, validatepassword, watch, tokens, cspreport, stashedit
- Default: help
- format
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Ä).
- Jedna z následujÃcÃch hodnot: json, jsonfm, none, php, phpfm, rawfm, xml, xmlfm
- Default: 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.- Type: integer
- smaxage
Nastavà HTTP hlaviÄku pro ÅÃzenà keÅ¡ovánÃ
s-maxagena uvedený poÄet sekund. Chyby se nekeÅ¡ujà nikdy.- Type: integer
- Default: 0
- maxage
Nastavà HTTP hlaviÄku pro ÅÃzenà keÅ¡ovánÃ
max-agena uvedený poÄet sekund. Chyby se nekeÅ¡ujà nikdy.- Type: integer
- Default: 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 uživatelské jméno
- 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.
- Type: boolean (details)
- curtimestamp
Zahrnout do odpovÄdi aktuálnà Äasové razÃtko.
- Type: boolean (details)
- responselanginfo
Include the languages used for uselang and errorlang in the result.
- Type: boolean (details)
- 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.- 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.
- Default: user
- errorformat
Format to use for warning and error text output.
- plaintext
- Wikitext with HTML tags removed and entities replaced.
- wikitext
- Unparsed wikitext.
- 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.
- Jedna z následujÃcÃch hodnot: bc, html, none, plaintext, raw, wikitext
- Default: bc
- errorlang
Language to use for warnings and errors. action=query&meta=siteinfo with siprop=languages returns a list of language codes, or specify content to use this wiki's content language, or specify uselang to use the same value as the uselang parameter.
- Default: uselang
- errorsuselocal
If given, error texts will use locally-customized messages from the MediaWiki namespace.
- Type: boolean (details)
- 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 [otevÅÃt v pÃskoviÅ¡ti]
Datové typy
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
Expiry values 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-15T14:56:00Z. Additionally, the string now may be used to specify the current timestamp.
Š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.
Zásluhy
VývojáÅi API:
- Roan Kattouw (hlavnà vývojáŠzáÅà 2007â2009)
- Viktor Vasiljev
- Bryan Tong Minh
- Sam Reed
- Jurij Astrachan (tvůrce, hlavnà vývojáŠzáÅà 2006âzáÅà 2007)
- Brad Jorsch (hlavnà vývojáŠod 2013)
Své komentáÅe, návrhy Äi dotazy posÃlejte na [email protected] nebo založte chybové hlášenà na https://phabricator.wikimedia.org/.