Pomocník API MediaWiki
Toto je automaticky generovaná dokumentačná stránka MediaWiki Action API.
action=edit
- Tento modul vyžaduje práva na čítanie.
- Tento modul vyžaduje práva na zápis.
- Tento modul prijíma iba požiadavky POST.
- Zdroj: MediaWiki
- Licencia: GPL-2.0-or-later
Vytvárať a upravovať stránky.
- title
Názov stránky, ktorá sa má upraviť. Nemožno použiť spolu s pageid.
- pageid
ID stránky, ktorá sa má upraviť. Nemožno použiť spolu 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
Nadpis novej sekcie pri 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 (oddeľte pomocou | alebo alternatívy):
- minor
Označiť túto úpravu ako malú úpravu.
- Typ: logická hodnota (boolean) (podrobnosti)
- notminor
Neoznačovať túto úpravu ako malú úpravu, aj keď je nastavená používateľská voľba „Označovať všetky zmeny štandardne ako drobné“.
- Typ: logická hodnota (boolean) (podrobnosti)
- bot
Označiť túto úpravu ako úpravu bota.
- 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
Neupravovať stránku, ak už existuje.
- Typ: logická hodnota (boolean) (podrobnosti)
- nocreate
Vyvolať chybu, ak stránka neexistuje.
- Typ: logická hodnota (boolean) (podrobnosti)
- watch
- Zastarané.
Pridať stránku do zoznamu sledovaných aktuálneho používateľa.
- Typ: logická hodnota (boolean) (podrobnosti)
- unwatch
- Zastarané.
Odstrániť stránku zo zoznamu sledovaných aktuálneho používateľa.
- Typ: logická hodnota (boolean) (podrobnosti)
- watchlist
Bezpodmienečne pridať alebo odstrániť stránku zo zoznamu sledovaných aktuálneho používateľa, použiť nastavenia (ignorované pre botov) alebo nemeniť sledovanie.
- Jedna z nasledujúcich hodnôt: 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 vyriešiť presmerovania.
- Typ: logická hodnota (boolean) (podrobnosti)
- contentformat
Serializačný formát obsahu použitý pre vstupný text.
- Jedna z nasledujúcich hodnôt: 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 nasledujúcich hodnôt: css, javascript, json, text, unknown, vue, wikitext
- token
Token „csrf“ získaný z 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ázov stránky
- Akceptuje aj neexistujúce 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.
- Predvolené: (prázdne)
- 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.
- Predvolené: (prázdne)
- Upraviť stránku.
- api.php?action=edit&title=Test&summary=test%20summary&text=article%20content&baserevid=1234567&token=123ABC [otvoriť na pieskovisku]
- 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 [otvoriť na pieskovisku]
- 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 [otvoriť na pieskovisku]