MediaWiki API 說明
此頁為自動產生的 MediaWiki API 說明文件頁面。
說明文件與範例:https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page
action=watch
(main | watch)
- 此模組需要讀取權限。
- 此模組需要寫入權限。
- 此模組僅接受 POST 請求。
- 來源:MediaWiki
- 授權條款:GPL-2.0-or-later
從目前使用者的監視清單添加或移除頁面。
參數:
- title
- 已棄用。
要(取消)監視的頁面。請改用 titles。
- unwatch
若設定頁面,則會取消監視而非被監視。
- 類型:布林值(詳細資訊)
- continue
當有更多結果可用時,使用這個繼續。
- titles
要使用的標題清單。
- 將幾個值以 | 或 alternative 分隔。
- 值的最大數目為 50(用於客戶端允許的較高限制為 500)。
- pageids
要使用的頁面 ID 清單。
- 類型:整數列表
- 將幾個值以 | 或 alternative 分隔。
- 值的最大數目為 50(用於客戶端允許的較高限制為 500)。
- revids
要使用的修訂 ID 清單。
- 類型:整數列表
- 將幾個值以 | 或 alternative 分隔。
- 值的最大數目為 50(用於客戶端允許的較高限制為 500)。
- generator
執行指定查詢模組取得要處理的頁面清單。
注意:生成器參數名必須以「g」開頭,請查看範例。
- allcategories
- 列舉所有分類。
- alldeletedrevisions
- 依使用者或所在命名空間來列出所有已刪除的修訂。
- allfileusages
- 列出所有檔案用途,包含不存在的。
- allimages
- 按順序列舉所有圖片。
- alllinks
- 列舉所有指向所指定命名空間的連結。
- allpages
- 依序列舉在指定命名空間的所有頁面。
- allredirects
- 列出至命名空間的所有重新導向。
- allrevisions
- 列出所有修訂版本。
- alltransclusions
- 列出所有嵌入(頁面使用 {{x}} 來內嵌),包含不存在的。
- backlinks
- 找出連結至指定頁面的所有頁面。
- categories
- 列出頁面隸屬的所有分類。
- categorymembers
- 在指定的分類中列出所有頁面。
- deletedrevisions
- 取得已刪除修訂的資訊。
- duplicatefiles
- 基於雜湊值來列出指定檔案裡的所有重複檔案。
- embeddedin
- 找出內嵌(嵌入)指定頁面的所有頁面。
- exturlusage
- 列舉包含指定 URL 的頁面。
- fileusage
- 尋找使用到指定檔案的所有頁面。
- images
- 回傳指定頁面中包含的所有檔案。
- imageusage
- 尋找使用到指定圖片標題的所有頁面。
- iwbacklinks
- 找出連結至指定跨 wiki 連結的所有頁面。
- langbacklinks
- 找出連結至指定語言連結的所有頁面。
- links
- 回傳指定頁面的所有連結。
- linkshere
- 找出連結至指定頁面的所有頁面。
- pageswithprop
- 列出使用到指定頁面屬性的所有頁面。
- prefixsearch
- 執行頁面標題的前綴搜尋。
- protectedtitles
- 列出所有被創建保護的標題。
- querypage
- 取得透過特殊頁面 QueryPage-based 所提供的清單。
- random
- 取得隨機頁面集合
- recentchanges
- 列舉出近期變更。
- redirects
- 回傳連結至指定頁面的所有重新導向。
- revisions
- 取得修訂的資訊。
- search
- 執行全文搜尋。
- templates
- 回傳指定頁面中所有引用的頁面。
- transcludedin
- 找出嵌入至指定頁面的所有頁面。
- watchlist
- 取得在目前使用者的監視清單裡,頁面的近期變更。
- watchlistraw
- 列出在目前使用者的監視清單裡頭所有頁面。
- 單值:allcategories、alldeletedrevisions、allfileusages、allimages、alllinks、allpages、allredirects、allrevisions、alltransclusions、backlinks、categories、categorymembers、deletedrevisions、duplicatefiles、embeddedin、exturlusage、fileusage、images、imageusage、iwbacklinks、langbacklinks、links、linkshere、pageswithprop、prefixsearch、protectedtitles、querypage、random、recentchanges、redirects、revisions、search、templates、transcludedin、watchlist、watchlistraw
- redirects
自動解決在 titles、pageids、revids,以及由 generator 所回傳頁面裡的重新導向。
- 類型:布林值(詳細資訊)
- converttitles
如有需要,轉換標題成其它變體。這僅在 wiki 的內容語言支援變體轉換時有用。支援變體轉換的語言包含有en、crh、gan、iu、kk、ku、shi、sr、tg、uz和zh。
- 類型:布林值(詳細資訊)
- token
自 action=query&meta=tokens 接收的「watch」權杖。
- 此為必填參數。
範例:
- 監視頁面 Main Page。
- api.php?action=watch&titles=Main_Page&token=123ABC [在沙盒中開啟]
- 取消監視頁面 Main Page。
- api.php?action=watch&titles=Main_Page&unwatch=&token=123ABC [在沙盒中開啟]
- 監視在主命名空間最前的幾個頁面。
- api.php?action=watch&generator=allpages&gapnamespace=0&token=123ABC [在沙盒中開啟]