MediaWiki API 說明

此頁為自動產生的 MediaWiki API 說明文件頁面。

說明文件與範例:https://www.mediawiki.org/wiki/API

action=upload

main | upload
  • 此模組需要讀取權限。
  • 此模組需要寫入權限。
  • 此模組僅接受 POST 請求。
  • 来源:MediaWiki
  • 许可协议:GPL-2.0-or-later

上传文件,或获取正在等待中的上传的状态。

可以使用的几种方法:

  • 直接上传文件内容,使用file参数。
  • 成批上传文件,使用filesizechunkoffset参数。
  • 有MediaWiki服务器从URL检索一个文件,使用url参数。
  • 完成一次由于警告而失败的早前上传,使用filekey参数。

需要注意,当发送file时,HTTP POST必须做为一次文件上传(也就是使用multipart/form-data)完成。

參數:
filename

目标文件名。

comment

上传注释。如果没有指定text,那么它也被用于新文件的初始页面文本。

預設值:(空)
tags

更改标签以应用于上传日志记录和文件页面修订中。

多值 (以 |alternative 分隔):Twinkle
text

用于新文件的初始页面文本。

watch
已停用。

监视页面。

类型:布尔值(详细信息
watchlist

无条件地将页面加入至当前用户的监视列表或将其移除,使用设置或不更改监视。

單值:watchpreferencesnochange
預設值: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" 密鑰。

此參數為必填。