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
action=edit
- Tento modul vyžaduje oprávnění ke čtení.
- Tento modul vyžaduje oprávnění k zápisu.
- Tento modul přijímá pouze požadavky POST.
- Zdroj: MediaWiki
- Licence: GPL-2.0-or-later
Vytvářet a upravovat stránky.
- title
Název stránky, kterou chcete editovat. Nelze použít společně s pageid.
- pageid
ID stránky, která se má editovat. Není možné použít společně s title.
- Typ: celé číslo
- section
Identifikátor sekcie. 0 pre hornú sekciu, new pre novú sekciu. Často kladné celé číslo, ale môže byť aj nečíselný.
- sectiontitle
Název nové sekce při použití section=new.
- text
Obsah stránky.
- summary
Zhrnutie úprav.
Ak tento parameter nie je zadaný alebo je prázdny, zhrnutie úprav sa môže vygenerovať automaticky.
Pri použití section=new bez zadania sectiontitle sa hodnota tohto parametra použije namiesto toho ako nadpis sekcie a zhrnutie úprav sa vygeneruje automaticky.
Značky zmien, ktoré sa majú použiť na revíziu.
- Hodnoty (oddělené | nebo alternativou.):
- minor
Označit toto jako malou editaci
- Typ: logická hodnota (boolean) (podrobnosti)
- notminor
Nemalá editace.
- Typ: logická hodnota (boolean) (podrobnosti)
- bot
Označit tuto editaci jako editaci robota.
- Typ: logická hodnota (boolean) (podrobnosti)
- baserevid
ID základnej revízie, používa sa na detekciu konfliktov úprav. Možno ho získať cez action=query&prop=revisions. Konflikty so sebou samým spôsobia zlyhanie úpravy, pokiaľ nie je nastavené basetimestamp.
- Typ: celé číslo
- basetimestamp
Časová pečiatka základnej revízie, používa sa na detekciu konfliktov úprav. Možno ju získať cez action=query&prop=revisions&rvprop=timestamp. Konflikty so sebou samým sa ignorujú.
- Typ: časová pečiatka (povolené formáty)
- starttimestamp
Časová pečiatka začiatku procesu úprav, používa sa na detekciu konfliktov úprav. Vhodnú hodnotu možno získať pomocou curtimestamp pri začatí procesu úprav (napr. pri načítaní obsahu stránky na úpravu).
- Typ: časová pečiatka (povolené formáty)
- recreate
Ignorovať všetky chyby o tom, že stránka bola medzitým vymazaná.
- Typ: logická hodnota (boolean) (podrobnosti)
- createonly
Needitovat stránku, pokud již existuje.
- Typ: logická hodnota (boolean) (podrobnosti)
- nocreate
Pokud stránka neexistuje, vrátit chybu.
- Typ: logická hodnota (boolean) (podrobnosti)
- watch
- Zastaralý.
Přidat stránku na seznam sledovaných.
- Typ: logická hodnota (boolean) (podrobnosti)
- unwatch
- Zastaralý.
Odstranit stránku ze seznamu sledovaných.
- Typ: logická hodnota (boolean) (podrobnosti)
- watchlist
Bezpodmínečně přidat nebo odstranit stránku ze sledovaných stránek aktuálního uživatele, použít nastavení nebo neměnit sledování.
- Jedna z následujících hodnot: nochange, preferences, unwatch, watch
- Predvolené: preferences
- md5
MD5 hash parametra text alebo spojených parametrov prependtext a appendtext. Ak je nastavený, úprava sa nevykoná, pokiaľ hash nie je správny.
- prependtext
Pridať tento text na začiatok stránky alebo sekcie. Má prednosť pred text.
- appendtext
Pridať tento text na koniec stránky alebo sekcie. Má prednosť pred text.
Na pridanie novej sekcie použite section=new namiesto tohto parametra.
- undo
Vrátiť túto revíziu. Má prednosť pred text, prependtext a appendtext.
- Typ: celé číslo
- Hodnota nesmie byť menšia ako 0.
- undoafter
Vrátiť všetky revízie od undo po túto. Ak nie je nastavené, vráti sa len jedna revízia.
- Typ: celé číslo
- Hodnota nesmie byť menšia ako 0.
- redirect
Automaticky opravit přesměrování.
- Typ: logická hodnota (boolean) (podrobnosti)
- contentformat
Serializačný formát obsahu použitý pre vstupný text.
- Jedna z následujících hodnot: application/json, application/octet-stream, application/unknown, application/vue+xml, application/x-binary, text/css, text/javascript, text/plain, text/unknown, text/x-wiki, unknown/unknown
- contentmodel
Model obsahu nového obsahu.
- Jedna z následujících hodnot: css, javascript, json, text, unknown, vue, wikitext
- token
Token typu „csrf“ získaný pomocí action=query&meta=tokens.
Token by sa mal vždy posielať ako posledný parameter alebo aspoň za parametrom text.
- Tento parameter je povinný.
- returnto
Názov stránky. Ak uloženie úpravy vytvorilo dočasný účet, API môže odpovedať URL adresou, ktorú by mal klient navštíviť na dokončenie prihlásenia. Ak je zadaný tento parameter, URL presmeruje na danú stránku namiesto stránky, ktorá bola upravená.
- Typ: název stránky
- Přijímá neexistující stránky
- returntoquery
Parametre URL dotazu (so začiatočným ?). Ak uloženie úpravy vytvorilo dočasný účet, API môže odpovedať URL adresou, ktorú by mal klient navštíviť na dokončenie prihlásenia. Ak je zadaný tento parameter, URL presmeruje na stránku s danými parametrami dotazu.
- Implicitní hodnota: (prázdné)
- returntoanchor
Fragment URL (so začiatočným #). Ak uloženie úpravy vytvorilo dočasný účet, API môže odpovedať URL adresou, ktorú by mal klient navštíviť na dokončenie prihlásenia. Ak je zadaný tento parameter, URL presmeruje na stránku s daným fragmentom.
- Implicitní hodnota: (prázdné)
- Upravit stránku.
- api.php?action=edit&title=Test&summary=test%20summary&text=article%20content&baserevid=1234567&token=123ABC [otevřít v pískovišti]
- Pridať __NOTOC__ na začiatok stránky.
- api.php?action=edit&title=Test&summary=NOTOC&minor=&prependtext=__NOTOC__%0A&basetimestamp=2007-08-24T12:34:54Z&token=123ABC [otevřít v pískovišti]
- Vrátiť revízie 13579 až 13585 s automatickým zhrnutím.
- api.php?action=edit&title=Test&undo=13585&undoafter=13579&basetimestamp=2007-08-24T12:34:54Z&token=123ABC [otevřít v pískovišti]