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
- 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, was uploaded in pieces, or stored otherwise in the upload stash, 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 or chunk.
- 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)
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ę.
- Typ: wartość boolowska (szczegóły)
- 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.
- Typ: wartość boolowska (szczegóły)
- 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.
- Typ: wartość boolowska (szczegóły)
- 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.
- Typ: wartość boolowska (szczegóły)
- checkstatus
Only fetch the upload status for the given file key.
- Typ: wartość boolowska (szczegóły)
- token
Token „csrf” pobrany z action=query&meta=tokens
- Ten parametr jest wymagany.
- 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]