MediaWiki API 幫助

這是自動(dòng)生成的MediaWiki API文檔頁面。

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

action=upload

（main | upload）
  • 此模塊需要讀取權(quán)限。
  • 此模塊需要寫入權(quán)限。
  • 此模塊只允許POST請(qǐng)求。
  • 來源：MediaWiki
  • 許可協(xié)議：GPL-2.0+

上傳一個(gè)文件，或獲取正在等待中的上傳的狀態(tài)。

可以使用的幾種方法：

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

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

參數(shù)：
filename

目標(biāo)文件名。

comment

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

默認(rèn)：（空）
tags

更改標(biāo)簽以應(yīng)用于上傳日志記錄和文件頁面修訂中。

值（以|分隔）：
text

用于新文件的初始頁面文本。

watch
不推薦使用。

監(jiān)視頁面。

類型：布爾值（詳細(xì)信息）
watchlist

無條件地將頁面加入至當(dāng)前用戶的監(jiān)視列表或?qū)⑵湟瞥?，使用設(shè)置或不更改監(jiān)視。

以下值中的一個(gè)：watch、preferences、nochange
默認(rèn)：preferences
ignorewarnings

忽略任何警告。

類型：布爾值（詳細(xì)信息）
file

文件內(nèi)容。

必須被公布為使用multipart/form-data的一次文件上傳。
url

要檢索文件來源的URL。

filekey

用于識(shí)別一次臨時(shí)藏匿的早前上傳的關(guān)鍵字。

sessionkey
不推薦使用。

與filekey相同，基于向后兼容而維護(hù)。

stash

如果設(shè)置，服務(wù)器將臨時(shí)藏匿文件而不是加入存儲(chǔ)庫。

類型：布爾值（詳細(xì)信息）
filesize

全部上傳的文件大小。

值必須介于0和104,857,600之間。
類型：整數(shù)
offset

塊的偏移量（字節(jié)）。

值必須不少于0。
類型：整數(shù)
chunk

大塊內(nèi)容。

必須被公布為使用multipart/form-data的一次文件上傳。
async

在可能的情況下，使?jié)撛诘拇笪募僮鳟惒竭M(jìn)行。

類型：布爾值（詳細(xì)信息）
checkstatus

只檢索指定文件密鑰的上傳狀態(tài)。

類型：布爾值（詳細(xì)信息）
token

從action=query&meta=tokens取回的“csrf”令牌

這個(gè)參數(shù)是必須的。