MediaWiki API 說明
此頁為自動產生的 MediaWiki API 說明文件頁面。
說明文件與範例:https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page
action=edit
- 此模組需要讀取權限。
- 此模組需要寫入權限。
- 此模組僅接受 POST 請求。
- 來源:MediaWiki
- 授權條款:GPL-2.0-or-later
建立與編輯頁面。
- title
您欲編輯的頁面標題。 無法與 pageid 同時使用。
- pageid
您欲編輯頁面的頁面 ID。 無法與 title 同時使用。
- 類型:整數
- section
章節編號。0 代表最上層章節,new 代表新章節。
- sectiontitle
新章節的標題。
- text
頁面內容。
- summary
編輯摘要。 當未設定 section=new 與 sectiontitle 時也會當做章節標題。
- tags
更改套用到修訂的標籤。
- 多值 (以 | 或 alternative 分隔):
- minor
標記此編輯為小編輯。
- 類型:布林值(詳細資訊)
- notminor
不要標記此編輯為小編輯,即使有設定到「預設將所有編輯標記為次要修訂」使用者偏好設定。
- 類型:布林值(詳細資訊)
- bot
標記此編輯為機器人編輯。
- 類型:布林值(詳細資訊)
- baserevid
基於修訂的 ID,可用來檢測編輯衝突。也可透過 action=query&prop=revisions 取得。若有設定 basetimestamp 的話,自我衝突會導致編輯失敗。
- 類型:整數
- basetimestamp
基於修訂的時間戳記,可用來檢測編輯衝突。也可透過 action=query&prop=revisions&rvprop=timestamp 取得。自我衝突則會被忽略。
- 類型:時間戳記(允許格式)
- starttimestamp
當編輯程序開始的時間戳記,用於偵測編輯衝突。當編輯程序開始時(例如:當載入要編輯的頁面內容),使用 curtimestamp 可以取得一個適當值。
- 類型:時間戳記(允許格式)
- recreate
覆蓋有關頁面在此期間已被刪除的任何錯誤。
- 類型:布林值(詳細資訊)
- createonly
若頁面已存在,則不編輯頁面。
- 類型:布林值(詳細資訊)
- nocreate
若頁面不存在,則產生錯誤。
- 類型:布林值(詳細資訊)
- watch
- 已棄用。
加入目前頁面至您的監視清單。
- 類型:布林值(詳細資訊)
- unwatch
- 已棄用。
從您的監視清單中移除目前頁面。
- 類型:布林值(詳細資訊)
- watchlist
使用偏好設定無條件地將頁面加入至或移除自目前使用者的監視清單,或不更改監視。
- 單值:nochange、preferences、unwatch、watch
- 預設值:preferences
- md5
text 參數、或是 prependtext 和 appendtext 參數連接的 MD5 雜湊。若有設定,除非雜湊正確否則編輯不會完成。
- prependtext
添加此文字至頁面開頭。覆蓋text。
- appendtext
添加至頁面結尾的文字。覆蓋text。
使用 section=new 來添加新的段落,而非此參數。
- undo
復原此修訂。覆寫 text、prependtext 與 appendtext。
- 類型:整數
- 數值不可小於 0。
- undoafter
撤銷從 undo 至此為止的所有修訂。若不設定則僅會撤銷一次修訂。
- 類型:整數
- 數值不可小於 0。
- redirect
自動化解決重新導向。
- 類型:布林值(詳細資訊)
- contentformat
用於輸入文字的內容序列化格式。
- 單值:application/json、text/css、text/javascript、text/plain、text/x-wiki
- contentmodel
新內容的內容模組。
- 單值:GadgetDefinition、Scribunto、css、javascript、json、sanitized-css、text、wikitext
- token
自 action=query&meta=tokens 接收的「csrf」權杖。
權杖應用為發送的最後參數,或至少在 text 參數之後。
- 此為必填參數。
- 編輯頁面
- api.php?action=edit&title=Test&summary=test%20summary&text=article%20content&baserevid=1234567&token=123ABC [在沙盒中開啟]
- 前置頁面的 __NOTOC__。
- api.php?action=edit&title=Test&summary=NOTOC&minor=&prependtext=__NOTOC__%0A&basetimestamp=2007-08-24T12:34:54Z&token=123ABC [在沙盒中開啟]
- 撤銷從 13579 至 13585 之間的修訂,並帶自動生成的摘要。
- api.php?action=edit&title=Test&undo=13585&undoafter=13579&basetimestamp=2007-08-24T12:34:54Z&token=123ABC [在沙盒中開啟]