MediaWiki API ヘルプ

このページは自動生成された MediaWiki API の説明文書ページです。

説明文書と例: https://www.mediawiki.org/wiki/API

action=upload

(main | upload)
  • このモジュールは読み取りの権限を必要とします。
  • このモジュールは書き込みの権限を必要とします。
  • このモジュールは POST リクエストのみを受け付けます。
  • Source: MediaWiki
  • License: 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.

既定値: (空)
text

Initial page text for new files.

watch
廃止予定です。

このページをウォッチする。

Type: boolean (details)
watchlist

Unconditionally add or remove the page from the current user's watchlist, use preferences or do not change watch.

値 (次の値のいずれか1つ): watch、preferences、nochange
既定値: preferences
ignorewarnings

あらゆる警告を無視する。

Type: boolean (details)
file

File contents.

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.

Type: boolean (details)
filesize

Filesize of entire upload.

値は 0 以上 104,857,600 以下にしてください。
Type: integer
offset

Offset of chunk in bytes.

値は 0 以上にしてください。
Type: integer
chunk

Chunk contents.

multipart/form-data 形式でファイルをアップロードしてください。
async

Make potentially large file operations asynchronous when possible.

Type: boolean (details)
asyncdownload

Make fetching a URL asynchronous.

Type: boolean (details)
leavemessage

If asyncdownload is used, leave a message on the user talk page if finished.

Type: boolean (details)
statuskey

Fetch the upload status for this file key (upload by URL).

checkstatus

Only fetch the upload status for the given file key.

Type: boolean (details)
token

action=query&meta=tokens から取得した「csrf」トークン

このパラメーターは必須です。