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

ファイルをアップロードするか、保留中のアップロードの状態を取得します。

複数のメソッドが使用できます:

file パラメーターを用いて、ファイルコンテンツを直接アップロードする。
filesize、chunk、offset パラメーターを用いて、ファイルを分割してアップロードする。
url パラメーターを用いて、URLから直接MediaWikiサーバーにファイルを取得させる。
filekey パラメーターを用いて、警告により失敗した過去のアップロードを完了させる。

file パラメーターを用いてアップロードを行うときは、POSTメソッドでなければなりません（つまり multipart/form-data に設定する必要がある）

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

パラメーター:

その他一般パラメーターが利用可能です。

filename: 対象のファイル名。
comment: アップロードのコメント。新規ファイルのアップロードで text が指定されていない場合、初期ページテキストとしても使用されます。; 既定値: (空)
tags: アップロード記録とファイルページの版に適用するタグを変更する; 値 (| または別の文字列で区切る):
text: 新しいファイルの初期ページテキスト。
watch: 廃止予定です。; このページをウォッチする。; 型: 真偽値 (詳細)
watchlist: Unconditionally add or remove the page from the current user's watchlist, use preferences (ignored for bot users) or do not change watch.; 値 (次の値のいずれか1つ): nochange、preferences、watch; 既定: preferences
ignorewarnings: あらゆる警告を無視する。; 型: 真偽値 (詳細)
file: ファイルコンテンツ; ファイルアップロードには multipart/form-data を使って投稿してください。
url: ファイル取得元のURL.
filekey: 一時的に保存されていた過去のアップロードを識別するキー
sessionkey: 廃止予定です。; filekey と同様（互換性のために残されている）
stash: ファイルをリポジトリに追加せず、サーバー内で一時的に保管するようにする; 型: 真偽値 (詳細)
filesize: アップロード全体のファイルサイズ; 型: 整数; 値は0以上104,857,600以下です。
offset: チャンクのオフセット（単位：バイト）; 型: 整数; 値の下限は必ず0以上です。
chunk: コンテンツのチャンク; ファイルアップロードには multipart/form-data を使って投稿してください。
async: 大きなサイズのファイル操作を非同期で行えるようにする（可能な場合のみ）; 型: 真偽値 (詳細)
checkstatus: 指定されたファイルキーのアップロードステータスのみを取得する; 型: 真偽値 (詳細)
token: action=query&meta=tokens から取得した「csrf」トークン; この変数は必須です。

例:

URLからアップロードする。: api.php?action=upload&filename=Wiki.png&url=http%3A//upload.wikimedia.org/wikipedia/en/b/bc/Wiki.png&token=123ABC [サンドボックスで開く]
警告により失敗した過去のアップロードを完了させる。: api.php?action=upload&filename=Wiki.png&filekey=filekey&ignorewarnings=1&token=123ABC [サンドボックスで開く]