Pomoc API MediaWiki

To jest automatycznie wygenerowana strona dokumentacji API MediaWiki.

Dokumentacja i przykłady: https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page

action=upload

(main | upload)

Ten moduł wymaga praw odczytu.
Ten moduł wymaga praw zapisu.
Ten moduł akceptuje tylko żądania POST.
Źródło: MediaWiki
Licencja: GPL-2.0-or-later

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.

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

Parametry:

filename: Nazwa pliku docelowego.
comment: Upload comment. Also used as the initial page text for new files if text is not specified.; Domyślnie: (puste)
tags: Change tags to apply to the upload log entry and file page revision.; Wartości (oddziel za pomocą | lub alternatywy):
text: Initial page text for new files.
watch: Przestarzałe.; Obserwuj stronę.; Type: boolean (details)
watchlist: Unconditionally add or remove the page from the current user's watchlist, use preferences (ignored for bot users) or do not change watch.; Jedna z następujących wartości: nochange, preferences, watch; Domyślnie: preferences
ignorewarnings: Ignoruj wszystkie ostrzeżenia.; Type: boolean (details)
file: Zawartość pliku.; Musi być przesłana jako plik, z użyciem typu zawartości „multipart/form-data”.
url: URL to fetch the file from.
filekey: Key that identifies a previous upload that was stashed temporarily.
sessionkey: Przestarzałe.; Same as filekey, maintained for backward compatibility.
stash: If set, the server will stash the file temporarily instead of adding it to the repository.; Type: boolean (details)
filesize: Filesize of entire upload.; Typ: liczba całkowita; Wartość musi znajdować się pomiędzy 0 a 104 857 600.
offset: Offset of chunk in bytes.; Typ: liczba całkowita; Wartość nie może być mniejsza niż 0.
chunk: Chunk contents.; Musi być przesłana jako plik, z użyciem typu zawartości „multipart/form-data”.
async: Make potentially large file operations asynchronous when possible.; Type: boolean (details)
checkstatus: Only fetch the upload status for the given file key.; Type: boolean (details)
token: Token „csrf” pobrany z action=query&meta=tokens; Ten parametr jest wymagany.

Przykłady:

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 [otwórz w brudnopisie]
Complete an upload that failed due to warnings.: api.php?action=upload&filename=Wiki.png&filekey=filekey&ignorewarnings=1&token=123ABC [otwórz w brudnopisie]