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=upload

(main | upload)

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

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

Dostupných je niekoľko metód:

Nahrať obsah súboru priamo pomocou parametra file.
Nahrať súbor po častiach pomocou parametrov filesize, chunk a offset.
Nechať server MediaWiki stiahnuť súbor z URL pomocou parametra url.
Dokončiť skoršie nahranie, ktoré zlyhalo kvôli upozorneniam, bolo nahrané po častiach alebo bolo inak uložené v úložisku nahrávania, pomocou parametra filekey.

Upozorňujeme, že pri posielaní file alebo chunk sa HTTP POST musí vykonať ako nahranie súboru (t. j. pomocou multipart/form-data).

https://www.mediawiki.org/wiki/Special:MyLanguage/API:Upload

Parametry:

K dispozícii sú aj ďalšie všeobecné parametre.

filename: Názov cieľového súboru.
comment: Komentár nahrania. Ak nie je zadaný text, použije sa aj ako počiatočný text stránky pre nové súbory.; Implicitní hodnota: (prázdné)
tags: Značky zmien, ktoré sa majú použiť na položku záznamu nahraní a revíziu stránky súboru.; Hodnoty (oddělené | nebo alternativou.):
text: Počiatočný text stránky pre nové súbory.
watch: Zastaralý.; Sledovať stránku.; 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 následujících hodnot: nochange, preferences, watch; Predvolené: preferences
ignorewarnings: Ignorovať všetky upozornenia.; Typ: logická hodnota (boolean) (podrobnosti)
file: Obsah súboru.; Musí byť odoslané ako nahrávanie súboru pomocou multipart/form-data.
url: URL, z ktorej sa má súbor stiahnuť.
filekey: Kľúč identifikujúci predchádzajúce nahranie, ktoré bolo dočasne uložené.
sessionkey: Zastaralý.; Rovnaké ako filekey, zachované kvôli spätnej kompatibilite.
stash: Ak je nastavené, server súbor dočasne uloží namiesto pridania do úložiska.; Typ: logická hodnota (boolean) (podrobnosti)
filesize: Veľkosť celého nahrávaného súboru.; Typ: celé číslo; Hodnota musí byť medzi 0 a 104 857 600.
offset: Posun časti (chunk) v bajtoch.; Typ: celé číslo; Hodnota nesmie byť menšia ako 0.
chunk: Obsah časti (chunk).; Musí byť odoslané ako nahrávanie súboru pomocou multipart/form-data.
async: Vykonávať potenciálne veľké operácie so súbormi asynchrónne, ak je to možné.; Typ: logická hodnota (boolean) (podrobnosti)
checkstatus: Iba získať stav nahrávania pre daný kľúč súboru.; Typ: logická hodnota (boolean) (podrobnosti)
token: Token typu „csrf“ získaný pomocí action=query&meta=tokens.; Tento parameter je povinný.

Příklady:

Nahrať z URL.: api.php?action=upload&filename=Wiki.png&url=http%3A//upload.wikimedia.org/wikipedia/en/b/bc/Wiki.png&token=123ABC [otevřít v pískovišti]
Dokončiť nahranie, ktoré zlyhalo kvôli upozorneniam.: api.php?action=upload&filename=Wiki.png&filekey=filekey&ignorewarnings=1&token=123ABC [otevřít v pískovišti]