MediaWiki API 說明
此頁為自動產生的 MediaWiki API 說明文件頁面。
說明文件與範例:https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page
list=search (sr)
- 此模組需要讀取權限。
- 此模組可作為產生器使用。
- 來源:MediaWiki
- 授權條款:GPL-2.0-or-later
執行全文搜尋。
具體參數:
其他通用參數可用。
- srsearch
搜尋相符此值的頁面標題或內容。依據 wiki 所含有的搜尋後端工具,您可以使用搜尋字串來調用特殊搜尋功能。
- 此為必填參數。
- srnamespace
僅以這些命名空間搜尋。
- 多值 (以 | 或 alternative 分隔):0、1、2、3、4、5、6、7、8、9、10、11、12、13、14、15
- 要指定所有值,請使用*。
- 預設值:0
- srlimit
要回傳的頁面總數。
- 類型:整數或max
- 數值必須在 1 與 500 之間。
- 預設值:10
- sroffset
當更多結果可用時,使用這個繼續。可在 mediawiki.org 取得更多有關如何繼續查詢的詳細資訊。
- 類型:整數
- 數值不可小於 0。
- 預設值:0
- srwhat
要執行的搜尋類型。
- 單值:nearmatch、text、title
- srinfo
要回傳的詮釋資料。
- 多值 (以 | 或 alternative 分隔):rewrittenquery、suggestion、totalhits
- 預設值:totalhits|suggestion|rewrittenquery
- srprop
要回傳的屬性:
- size
- 添加以位元組為單位的頁面大小。
- wordcount
- 添加頁面的字數。
- timestamp
- 添加頁面自上一次編輯的時間戳記。
- snippet
- 添加頁面片段,並突出標記查詢詞。
- titlesnippet
- 添加頁面標題,並突出標記查詢詞。
- redirecttitle
- 添加符合重新導向的標題。
- redirectsnippet
- 添加匹配的重新導向標題,並突出標記查詢詞。
- sectiontitle
- 添加符合段落的標題。
- sectionsnippet
- 添加匹配的章節標題,並突出標記查詢詞。
- isfilematch
- 添加表明搜尋是否符合檔案內容的布林值。
- categorysnippet
- 添加匹配的分類名稱,並突出標記查詢詞。
- score
- 已棄用。已忽略
- hasrelated
- 已棄用。已忽略
- extensiondata
- 添加由擴充所產生的額外資料。
- 多值 (以 | 或 alternative 分隔):categorysnippet、extensiondata、isfilematch、redirectsnippet、redirecttitle、sectionsnippet、sectiontitle、size、snippet、timestamp、titlesnippet、wordcount、hasrelated、score
- 預設值:size|wordcount|timestamp|snippet
- srinterwiki
若可用的話,在搜尋裡包含跨 wiki 結果。
- 類型:布林值(詳細資訊)
- srenablerewrites
啟用內部查詢重新寫入。一些搜尋後端可重新寫入查詢成其它被認為能提供更好的結果,比如糾正拼寫錯誤。
- 類型:布林值(詳細資訊)
- srsort
設定回傳結果的排序。
- 單值:relevance
- 預設值:relevance
範例:
- 搜尋 meaning。
- api.php?action=query&list=search&srsearch=meaning [在沙盒中開啟]
- 搜尋 meaning 的文字。
- api.php?action=query&list=search&srwhat=text&srsearch=meaning [在沙盒中開啟]
- 取得有關回傳搜尋 meaning 相關內容頁面的頁面資訊。
- api.php?action=query&generator=search&gsrsearch=meaning&prop=info [在沙盒中開啟]