MediaWiki API 說明
此頁為自動產生的 MediaWiki API 說明文件頁面。
說明文件與範例:https://www.mediawiki.org/wiki/API
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
)完成。
參數:
- filename
目標檔案名稱。
- comment
上傳註釋。如果 text 未指定的話,也會作為新檔案用的初始頁面文字。
- 預設值:(空)
- tags
更改标签以应用于上传日志记录和文件页面修订中。
- 多值 (以 | 或 alternative 分隔):
- text
用於新檔案的初始頁面文字。
- watch
- 已停用。
監視頁面。
- 類型:布林值(詳細資訊)
- watchlist
无条件地将页面加入至当前用户的监视列表或将其移除,使用设置或不更改监视。
- 單值:watch、preferences、nochange
- 預設值: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" 密鑰。
- 此參數為必填。