MediaWiki API 帮助
这是一个自动生成的 MediaWiki API 文档页面。
文档和示例： https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page
action=upload
( | upload)
- 此模块需要读取权限。
- 此模块需要写入权限。
- 此模块仅接受 POST 请求。
- 来源： MediaWiki
- 许可：
上传文件，或获取待处理上传的状态。
有几种可用的方法
- 使用 file 参数直接上传文件内容。
- 使用 filesize、chunk 和 offset 参数分段上传文件。
- 使用 url 参数让 MediaWiki 服务器从 URL 获取文件。
- 使用 filekey 参数完成由于警告而失败的早期上传，或者分段上传的文件，或者以其他方式存储在上传暂存区中的文件。
请注意，当发送 file 或 chunk 时，HTTP POST 必须作为文件上传完成（即使用 multipart/form-data）。
特定参数
其他通用参数可用。
- filename
目标文件名。
- comment
上传评论。如果未指定 text，也用作新文件的初始页面文本。
- 默认值：(空)
应用于上传日志条目和文件页面修订的更改标签。
- 值（用 | 或 备用选项 分隔）
- text
新文件的初始页面文本。
- watch
- 已弃用。
监视页面。
- 类型：布尔值（详情）
- watchlist
无条件地将页面添加到当前用户的监视列表或从中移除，使用偏好设置（对机器人用户无效）或不更改监视状态。
- 下列值之一：nochange、preferences、watch
- 默认：preferences
- watchlistexpiry
监视列表到期时间戳。完全省略此参数可保留当前到期时间不变。
- 类型：expiry (details)
- ignorewarnings
忽略任何警告。
- 类型：布尔值（详情）
- file
文件内容。
- 必须使用 multipart/form-data 的文件上传方式进行 POST。
- url
从中获取文件的 URL。
- filekey
标识先前临时存储的上传的键。
- sessionkey
- 已弃用。
与 filekey 相同，为保持向后兼容性而保留。
- stash
如果设置，服务器将暂时暂存文件而不是将其添加到存储库中。
- 类型：布尔值（详情）
- filesize
整个上传文件的大小。
- 类型：integer
- 该值必须介于 0 和 5,368,709,120 之间。
- offset
块的字节偏移量。
- 类型：integer
- 该值不得小于 0。
- chunk
块内容。
- 必须使用 multipart/form-data 的文件上传方式进行 POST。
- async
在可能的情况下使潜在的大文件操作异步化。
- 类型：布尔值（详情）
- checkstatus
仅获取给定文件键的上传状态。
- 类型：布尔值（详情）
- token
从 action=query&meta=tokens 获取的 "csrf" token
- 此参数是必需的。
示例
