MediaWiki API 說明
此頁為自動產生的 MediaWiki API 說明文件頁面。
說明文件與範例:https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page
action=rollback
(main | rollback)
- 此模組需要讀取權限。
- 此模組需要寫入權限。
- 此模組僅接受 POST 請求。
- 來源:MediaWiki
- 授權條款:GPL-2.0-or-later
復原頁面的最後一次編輯。
若編輯頁面的上一個使用者連續建立多個編輯,這些會全部被回退。
參數:
- title
要回退的頁面標題。不可與 pageid 同時使用。
- pageid
要回退的頁面 ID。不可與 title 同時使用。
- 類型:整數
- tags
套用到回退的標籤。
- 多值 (以 | 或 alternative 分隔):
- user
編輯被回退的使用者名稱。
- 此為必填參數。
- 類型:使用者,按任何使用者名稱、IP、跨 wiki 名稱(例如:"prefix>ExampleName")和使用者 ID(例如:"#12345")
- summary
自定義編輯摘要。若為空,則使用預設摘要。
- 預設值:(空)
- markbot
將回退的編輯以及回退操作標記為機器人所做編輯。
- 類型:布林值(詳細資訊)
- watchlist
使用偏好設定無條件地將頁面加入至或移除自目前使用者的監視清單,或不更改監視。
- 單值:nochange、preferences、unwatch、watch
- 預設值:preferences
- token
自 action=query&meta=tokens 接收的「rollback」權杖。
為顧及相容性,web UI 中使用的權杖(Token)也是可接受的。
- 此為必填參數。
範例:
- 回退由使用者 Example 對頁面 Main Page 所做的最新編輯。
- api.php?action=rollback&title=Main%20Page&user=Example&token=123ABC [在沙盒中開啟]
- 帶編輯摘要 Reverting vandalism 來回退由 IP 使用者 192.0.2.5 對頁面 Main Page 所做的最新編輯,並標記這些編輯與回退為機器人做出的編輯。
- api.php?action=rollback&title=Main%20Page&user=192.0.2.5&token=123ABC&summary=Reverting%20vandalism&markbot=1 [在沙盒中開啟]