MediaWiki API 帮助

这是自动生成的MediaWiki API文档页面。

文档和例子：-{R|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参数。
有MediaWiki服务器从URL检索一个文件，使用url参数。
完成一次由于警告而失败的早前上传，使用filekey参数。

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

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

具体参数：

其他通用参数可用。

filename: 目标文件名。
comment: 上传注释。如果没有指定text，那么它也被用于新文件的初始页面文本。; 默认：（空）
tags: 更改标签以应用于上传日志记录和文件页面修订中。; 值（以|或替代物分隔）：
text: 用于新文件的初始页面文本。
watch: 已弃用。; 监视页面。; 类型：布尔型 (详情)
watchlist: 无条件地将页面加入至当前用户的监视列表或将其移除（忽略机器人用户），使用设置或不更改监视。; 以下值中的一个：nochange、preferences、watch; 默认：preferences
ignorewarnings: 忽略任何警告。; 类型：布尔型 (详情)
file: 文件内容。; 必须使用POST方法及multipart/form-data作为文件上传。
url: 要检索文件来源的URL。
filekey: 标识之前临时存储的上传内容的密钥。
sessionkey: 已弃用。; 与filekey相同，基于向后兼容而维护。
stash: 如果设置，服务器将临时藏匿文件而不是加入存储库。; 类型：布尔型 (详情)
filesize: 全部上传的文件大小。; 类型：整数; 值必须介于0和104,857,600之间。
offset: 数据块的偏移量（字节）。; 类型：整数; 值必须不少于0。
chunk: 大块内容。; 必须使用POST方法及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 [在沙盒中打开]