MediaWiki API ヘルプ

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

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

action=upload

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

パラメーター:
filename

対象のファイル名。

comment

アップロードのコメント。新規ファイルのアップロードで text が指定されていない場合、初期ページテキストとしても使用されます。

既定値: (空)
tags

Change tags to apply to the upload log entry and file page revision.

値 (|もしくは別の文字列で区切る):
text

新しいファイルの初期ページテキスト。

watch
廃止予定です。

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

型: 真偽値 (詳細)
watchlist

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

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

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

型: 真偽値 (詳細)
file

File contents.

Must be posted as a file upload using multipart/form-data.
url

ファイル取得元のURL.

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.

型: 整数
The value must be between 0 and 104,857,600.
offset

Offset of chunk in bytes.

型: 整数
The value must be no less than 0.
chunk

Chunk contents.

Must be posted as a file upload using multipart/form-data.
async

Make potentially large file operations asynchronous when possible.

型: 真偽値 (詳細)
checkstatus

Only fetch the upload status for the given file key.

型: 真偽値 (詳細)
token

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

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