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 參數。
- 分批上傳檔案，請使用 filesize、chunk、以及 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」權杖。
- 此為必填參數。
![[在沙盒中開啟]](/wiki/%E7%89%B9%E6%AE%8A:ApiSandbox#action=upload&filename=Wiki.png&url=http%3A//upload.wikimedia.org/wikipedia/en/b/bc/Wiki.png&token=123ABC){kind=link}
![[在沙盒中開啟]](/wiki/%E7%89%B9%E6%AE%8A:ApiSandbox#action=upload&filename=Wiki.png&filekey=filekey&ignorewarnings=1&token=123ABC){kind=link}