MediaWiki API 說明
此頁為自動產生的 MediaWiki API 說明文件頁面。
說明文件與範例:https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page
prop=deletedrevisions (drv)
- 此模組需要讀取權限。
- 此模組可作為產生器使用。
- 來源:MediaWiki
- 授權條款:GPL-2.0-or-later
取得已刪除修訂的資訊。
能以多種方式使用:
- 透過設定標題或頁面 ID,來取得頁面集的已刪除修訂。排序是依照標題和時間戳記。
- 透過以修訂 ID 來設定它們的 ID,來取得已刪除修訂集的相關資料。排序是依照修訂 ID。
- drvprop
各修訂所要取得的屬性:
- ids
- 修訂 ID。
- flags
- 修訂標籤(小修改)。
- timestamp
- 修訂的時間戳記。
- user
- 做出修訂的使用者。若是已刪除修訂的使用者,會回傳 userhidden 屬性。
- userid
- 修訂創建者的使用者 ID。若是已刪除修訂的使用者,會回傳 userhidden 屬性。
- size
- 修訂的長度(位元組)。
- slotsize
- 各修訂間隔的長度(位元組)。
- sha1
- 修訂的 SHA-1(base 16)。若是已刪除修訂的內容,會回傳 sha1hidden 屬性。
- slotsha1
- 各修訂間隔的 SHA-1(base 16)。若是已刪除修訂的內容,會回傳 sha1hidden 屬性。
- contentmodel
- 各修訂間隔的內容模組 ID。
- comment
- 由使用者對於修訂所做出的註釋。若是已刪除修訂的註釋,會回傳 commenthidden 屬性。
- parsedcomment
- 由使用者對於修訂所解析的註釋。若是已刪除修訂的註釋,會回傳 commenthidden 屬性。
- content
- 各修訂間隔的內容。若是已刪除修訂的內容,會回傳 texthidden 屬性。
- tags
- 修訂標籤。
- roles
- 列出存在於修訂的內容間隔作用。
- parsetree
- 已棄用。請改用 action=expandtemplates 或 action=parse。修訂內容的 XML 解析樹狀(需要內容模組
wikitext
)。
- 多值 (以 | 或 alternative 分隔):comment、content、contentmodel、flags、ids、parsedcomment、roles、sha1、size、slotsha1、slotsize、tags、timestamp、user、userid、parsetree
- 預設值:ids|timestamp|flags|comment|user
- drvslots
當間隔相關屬性包含在 drvprops 時,要回傳資料的修訂間隔。若忽略的話,來自 main 間隔的資料會以向下兼容格式回傳。
- 多值 (以 | 或 alternative 分隔):main
- 要指定所有值,請使用*。
- drvlimit
限制所回傳的修訂數量。
- 類型:整數或max
- 數值必須在 1 與 500 之間。
- drvexpandtemplates
- 已棄用。
請改用 action=expandtemplates。在修訂內容裡展開模板(需要 drvprop=content)。
- 類型:布林值(詳細資訊)
- drvgeneratexml
- 已棄用。
請改用 action=expandtemplates 或 action=parse。產生用於修訂內容的 XML 解析樹狀(需要 drvprop=content)。
- 類型:布林值(詳細資訊)
- drvparse
- 已棄用。
請改用 action=parse。解析修訂內容(需要 drvprop=content)。基於效能緣故,若有使用此選項,drvlimit 會被強制為 1。
- 類型:布林值(詳細資訊)
- drvsection
僅檢索此段落號碼的內容。
- drvdiffto
- 已棄用。
請改用 action=compare。要比較各修訂差異的修訂 ID。prev 與 next 和 cur 分別用於上一個、下一個、以及目前的修訂。
- drvdifftotext
- 已棄用。
請改用 action=compare。要比較各修訂差異的文字。僅能比對受限數目的修訂。覆蓋 drvdiffto。若 drvsection 有設定,僅能比對該與文字有差別的段落。
- drvdifftotextpst
- 已棄用。
請改用 action=compare。在區別前,執行在文字上的預先儲存轉換。僅與 drvdifftotext 使用有效。
- 類型:布林值(詳細資訊)
- drvcontentformat
- 已棄用。
使用於 drvdifftotext 的序列化格式並預期用於內容輸出。
- 單值:application/json、application/octet-stream、application/unknown、application/x-binary、text/css、text/javascript、text/plain、text/unknown、text/x-wiki、unknown/unknown
- drvstart
要開始列舉的時間戳記。當處理修訂 ID 清單時會被忽略。
- 類型:時間戳記(允許格式)
- drvend
要停止列舉的時間戳記。當處理修訂 ID 清單時會被忽略。
- 類型:時間戳記(允許格式)
- drvdir
列舉的方向:
- newer
- 最早的優先。注意:drvstart應在drvend之前。
- older
- 最新的優先(預設)。注意:drvstart應在drvend之後。
- 單值:newer、older
- 預設值:older
- drvtag
僅列出以此標籤所標記的修訂。
- drvuser
此列出由該使用者作出的修訂。
- 類型:使用者,按任何使用者名稱、IP、跨 wiki 名稱(例如:"prefix>ExampleName")和使用者 ID(例如:"#12345")
- drvexcludeuser
不要列出由該使用者作出的修訂。
- 類型:使用者,按任何使用者名稱、IP、跨 wiki 名稱(例如:"prefix>ExampleName")和使用者 ID(例如:"#12345")
- drvcontinue
當有更多結果可用時,使用這個繼續。
- 列出頁面 Main Page 與 Talk:Main Page 包含到內容的已刪除修訂。
- api.php?action=query&prop=deletedrevisions&titles=Main%20Page|Talk:Main%20Page&drvslots=*&drvprop=user|comment|content [在沙盒中開啟]
- 列出已刪除修訂 123456 的資訊。
- api.php?action=query&prop=deletedrevisions&revids=123456 [在沙盒中開啟]