MediaWiki API 帮助
这是自动生成的MediaWiki Action API文档页面。
action=upload
- 此模块需要读取权限。
- 此模块需要写入权限。
- 此模块只允许POST请求。
- 来源：MediaWiki
- 许可协议：GPL-2.0-or-later
上传文件，或获取正在等待中的上传的状态。
可以使用的几种方法：
- 直接上传文件内容，使用file参数。
- 成批上传文件，使用filesize、chunk和offset参数。
- 有MediaWiki服务器从URL检索一个文件，使用url参数。
- 完成一次由于警告而失败的早前上传，使用filekey参数。
需要注意，当发送file时，HTTP POST必须做为一次文件上传（也就是使用multipart/form-data）完成。
- filename
目标文件名。如果未设置，且使用了file，则会使用该文件的文件名。
- comment
上传注释。如果未设置text，那么它也被用于新文件的初始页面文本。
- 默认：（空）
更改标签以应用于上传日志记录和文件页面修订中。
- 值（以|或替代物分隔）：AWB、Twinkle
- text
用于新文件的初始页面文本。
- watch
- 已弃用。
监视页面。
- 类型：布尔型 (详情)
- watchlist
无条件地将页面加入至当前用户的监视列表或将其移除（忽略机器人用户），使用设置或不更改监视。
- 以下值中的一个：nochange、preferences、watch
- 默认：preferences
- watchlistexpiry
监视列表期限时间戳。完全忽略该参数可保持当前期限不变。
- 类型：过期（详情）
- ignorewarnings
忽略任何警告。
- 类型：布尔型 (详情)
- file
文件内容和其他详细信息。您必须提供此参数、filekey或url。
- 必须使用POST方法及multipart/form-data作为文件上传。
- url
要检索文件来源的URL。您必须提供此参数、file或filekey。
- filekey
标识之前临时存储的上传内容的密钥。您必须提供此参数、file或url。
- sessionkey
- 已弃用。
与filekey相同，基于向后兼容而维护。
- stash
如果设置，服务器将临时藏匿文件而不是加入存储库。
- 类型：布尔型 (详情)
- filesize
全部上传的文件大小。
- 类型：整数
- 值必须介于0和5,368,709,120之间。
- offset
数据块的偏移量（字节）。
- 类型：整数
- 值必须不少于0。
- chunk
大块内容。
- 必须使用POST方法及multipart/form-data作为文件上传。
- async
在可能的情况下，使潜在的大文件操作异步进行。
- 类型：布尔型 (详情)
- checkstatus
只检索指定文件密钥的上传状态。
- 类型：布尔型 (详情)
- autotext
从comment、license、copystatus和 source参数在服务器端生成文件描述页面的wikitext，并覆盖text参数。扩展可以通过UploadForm:getInitialPageText钩子修改所生成的文本。autotext参数的存在是为了允许action=upload与Special:Upload和importImages维护脚本的行为保持一致。
- 类型：布尔型 (详情)
- license
该上传所选择的许可证。这是一个模板名称。仅与autotext一起使用，用于生成文件描述页面的wikitext。
- 默认：（空）
- token
从action=query&meta=tokens取回的“csrf”令牌
- 这个参数是必需的。
![[在沙盒中打开]](/wiki/Special:ApiSandbox#action=upload&filename=Wiki.png&url=http%3A//upload.wikimedia.org/wikipedia/en/b/bc/Wiki.png&token=123ABC){kind=link}
![[在沙盒中打开]](/wiki/Special:ApiSandbox#action=upload&filename=Wiki.png&filekey=filekey&ignorewarnings=1&token=123ABC){kind=link}