MediaWiki API 說明
此頁為自動產生的 MediaWiki API 說明文件頁面。
說明文件與範例:https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page
action=setnotificationtimestamp
(main | setnotificationtimestamp)
- 此模組需要讀取權限。
- 此模組需要寫入權限。
- 此模組僅接受 POST 請求。
- 來源:MediaWiki
- 授權條款:GPL-2.0-or-later
更新監視頁面的通知時間戳記。
這會影響在監視清單與歷史裡更改頁面的亮度凸顯,以及當 "當我的監視清單中的頁面或檔案有變更時,傳送電子郵件通知我" 偏好設定啟用時的電子郵件發送。
參數:
- entirewatchlist
在所有已監視頁面運作。
- 類型:布林值(詳細資訊)
- timestamp
要設定通知時間戳記的時間戳記。
- 類型:時間戳記(允許格式)
- torevid
設定通知時間戳記的修訂(僅限一個頁面)。
- 類型:整數
- newerthanrevid
設定通知時間戳記較新的修訂(僅限一個頁面)。
- 類型:整數
- 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 接收的「csrf」權杖。
- 此為必填參數。
範例:
- 重新設定整個監視清單的通知狀態。
- api.php?action=setnotificationtimestamp&entirewatchlist=&token=123ABC [在沙盒中開啟]
- 重新設定用於 Main page 的通知狀態。
- api.php?action=setnotificationtimestamp&titles=Main_page&token=123ABC [在沙盒中開啟]
- 設定 Main page 的通知時間戳記,讓所有自 2012 年 1 月起的編輯為未查看。
- api.php?action=setnotificationtimestamp&titles=Main_page×tamp=2012-01-01T00:00:00Z&token=123ABC [在沙盒中開啟]
- 重新設定在 使用者 命名空間裡頁面的通知狀態。
- api.php?action=setnotificationtimestamp&generator=allpages&gapnamespace=2&token=123ABC [在沙盒中開啟]