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
action=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+
Upload a file, or get the status of pending uploads.
Several methods are available:
- Upload file contents directly, using the file parameter.
- Upload the file in pieces, using the filesize, chunk, and offset parameters.
- Have the MediaWiki server fetch a file from a URL, using the url parameter.
- Complete an earlier upload that failed due to warnings, using the filekey parameter.
Note that the HTTP POST must be done as a file upload (i.e. using multipart/form-data) when sending the file.
- filename
Target filename.
- comment
Upload comment. Also used as the initial page text for new files if text is not specified.
- Implicitní hodnota: (prázdné)
- tags
Change tags to apply to the upload log entry and file page revision.
- Hodnoty (oddělené |):
- text
Initial page text for new files.
- watch
- Zastaralý.
Watch the page.
- Typ: boolean (podrobnosti)
- watchlist
Unconditionally add or remove the page from the current user's watchlist, use preferences or do not change watch.
- Jedna z následujících hodnot: watch, preferences, nochange
- Implicitní hodnota: preferences
- ignorewarnings
Ignore any warnings.
- Typ: boolean (podrobnosti)
- file
File contents.
- Musí se odeslat POST požadavkem jako načítaný soubor pomocí multipart/form-data.
- url
URL to fetch the file from.
- filekey
Key that identifies a previous upload that was stashed temporarily.
- sessionkey
- Zastaralý.
Same as filekey, maintained for backward compatibility.
- stash
If set, the server will stash the file temporarily instead of adding it to the repository.
- Typ: boolean (podrobnosti)
- filesize
Filesize of entire upload.
- Hodnota musí ležet mezi 0 a 104 857 600.
- Typ: celé číslo
- offset
Offset of chunk in bytes.
- Hodnota nesmí být nižší než 0.
- Typ: celé číslo
- chunk
Chunk contents.
- Musí se odeslat POST požadavkem jako načítaný soubor pomocí multipart/form-data.
- async
Make potentially large file operations asynchronous when possible.
- Typ: boolean (podrobnosti)
- checkstatus
Only fetch the upload status for the given file key.
- Typ: boolean (podrobnosti)
- token
Token typu „csrf“ získaný pomocí action=query&meta=tokens.
- Tento parametr je povinný.
- Upload from a URL.
- api.php?action=upload&filename=Wiki.png&url=http%3A//upload.wikimedia.org/wikipedia/en/b/bc/Wiki.png&token=123ABC [open in sandbox]
- Complete an upload that failed due to warnings.
- api.php?action=upload&filename=Wiki.png&filekey=filekey&ignorewarnings=1&token=123ABC [open in sandbox]
![[open in sandbox]](/w/Speci%C3%A1ln%C3%AD:API_p%C3%ADskovi%C5%A1t%C4%9B#action=upload&filename=Wiki.png&url=http%3A//upload.wikimedia.org/wikipedia/en/b/bc/Wiki.png&token=123ABC){kind=link}
![[open in sandbox]](/w/Speci%C3%A1ln%C3%AD:API_p%C3%ADskovi%C5%A1t%C4%9B#action=upload&filename=Wiki.png&filekey=filekey&ignorewarnings=1&token=123ABC){kind=link}