MediaWiki API 幫助

這是自動生成的MediaWiki API文檔頁面。

文檔和例子：https://www.mediawiki.org/wiki/API:Main_page/zh

action=upload

（main | upload）
  • 此模塊需要讀取權限。
  • 此模塊需要寫入權限。
  • 此模塊只允許POST請求。
  • 來源：MediaWiki
  • 許可協議：GPL-2.0+

上傳一個文件，或獲取正在等待中的上傳的狀態。

可以使用的幾種方法：

  • 直接上傳文件內容，使用file參數。
  • 成批上傳文件，使用filesize、chunk和offset參數。
  • 有MediaWiki服務器從URL檢索一個文件，使用url參數。
  • 完成一次由于警告而失敗的早前上傳，使用filekey參數。

需要注意，當發送file時，HTTP POST必須做為一次文件上傳（也就是使用multipart/form-data）完成。

參數：
filename

目標文件名。

comment

上傳注釋。如果沒有指定text，那么它也被用于新文件的初始頁面文本。

默認：（空）
tags

更改標簽以應用于上傳日志記錄和文件頁面修訂中。

值（以|分隔）：
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”令牌

這個參數是必須的。