MediaWiki API 說明

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

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

action=edit

main | 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、​application/octet-stream、​application/unknown、​application/x-binary、​text/css、​text/javascript、​text/plain、​text/unknown、​text/x-wiki、​unknown/unknown
contentmodel

新內容的內容模組。

單值:css、​javascript、​json、​text、​unknown、​wikitext
token

action=query&meta=tokens 接收的「csrf」權杖。

權杖應用為發送的最後參數,或至少在 text 參數之後。

此為必填參數。