MediaWiki API 說明

此頁為自動產生的 MediaWiki API 說明文件頁面。

說明文件與範例:https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page

action=upload

main | upload
  • 此模組需要讀取權限。
  • 此模組需要寫入權限。
  • 此模組僅接受 POST 請求。
  • 來源:MediaWiki
  • 授權條款:GPL-2.0-or-later

上傳檔案,或取得等待上傳的狀態。

有以下方式可用:

  • 直接上傳檔案內容,請使用 file 參數。
  • 分批上傳檔案,請使用 filesizechunk、以及 offset 參數。
  • 擁有 MediaWiki 伺服器來從 URL 來檢索檔案,請使用 url 參數。
  • 要完成一個稍早出於警告而失敗的上傳,請使用 filekey 參數。

請注意當發送 file 時,HTTP POST 必須用做為檔案上傳(註:使用 multipart/form-data)。

參數:
filename

目標檔案名稱。

comment

上傳註釋。如果 text 未指定的話,也會作為新檔案用的初始頁面文字。

預設值:(空)
tags

更改標籤來套用到上傳日誌項目以及檔案頁面修訂。

多值 (以 |alternative 分隔):
text

用於新檔案的初始頁面文字。

watch
已棄用。

監視頁面。

類型:布林值(詳細資訊
watchlist

使用偏好設定無條件地將頁面加入至或移除自目前使用者的監視清單(略過機器人使用者),或不更改監視。

單值:nochange、​preferences、​watch
預設值: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」權杖。

此參數已棄用。