עזרה של MediaWiki API

זהו דף תיעוד של API שנוצר באופן אוטומטי.

תיעוד ודוגמאות: https://www.mediawiki.org/wiki/API

action=upload

(main | upload)

יחידה זו דורשת הרשאות קריאה.
יחידה זו דורשת הרשאות כתיבה.
יחידה זו מקבלת רק בקשות POST.

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/API:Upload

פרמטרים:

filename: Target filename.
comment: Upload comment. Also used as the initial page text for new files if text is not specified.; ברירת מחדל: (ריק)
text: Initial page text for new files.
watch: מיושן.; Watch the page.
watchlist: Unconditionally add or remove the page from the current user's watchlist, use preferences or do not change watch.; ערך אחד: watch, preferences, nochange; ברירת מחדל: preferences
ignorewarnings: Ignore any warnings.
file: File contents.; חייב להישלח (posted) בתור העלאת קובץ באמצעות multipart/form-data.
url: URL to fetch the file from.
filekey: Key that identifies a previous upload that was stashed temporarily.
sessionkey: מיושן.; Same as filekey, maintained for backward compatibility.
stash: If set, the server will stash the file temporarily instead of adding it to the repository.
filesize: Filesize of entire upload.
offset: Offset of chunk in bytes.
chunk: Chunk contents.; חייב להישלח (posted) בתור העלאת קובץ באמצעות multipart/form-data.
async: Make potentially large file operations asynchronous when possible.
asyncdownload: Make fetching a URL asynchronous.
leavemessage: If asyncdownload is used, leave a message on the user talk page if finished.
statuskey: Fetch the upload status for this file key (upload by URL).
checkstatus: Only fetch the upload status for the given file key.
token: אסימון "csrf" אוחזר מ־action=query&meta=tokens; פרמטר זה נדרש.

דוגמאות:

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