MediaWiki API 說明
此頁為自動產生的 MediaWiki API 說明文件頁面。
說明文件與範例:https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page
action=opensearch
(main | opensearch)
- 此模組需要讀取權限。
- 來源:MediaWiki
- 授權條款:GPL-2.0-or-later
使用 OpenSearch 協定搜尋本 wiki。
具體參數:
其他通用參數可用。
- search
搜尋字串。
- 此為必填參數。
- namespace
搜尋的命名空間。若 search 以有效的命名空間前綴為開頭則會被忽略。
- 多值 (以 | 或 alternative 分隔):0、1、2、3、4、5、6、7、8、9、10、11、12、13、14、15、110、111、420、421、500、501、502、503、828、829、1200、1201、1202、2000、2001、2002、2300、2301、2302、2303、2900、2901
- 要指定所有值,請使用*。
- 預設值:0
- limit
回傳的結果數量上限。
- 類型:整數或max
- 數值必須在 1 與 500 之間。
- 預設值:10
- profile
搜尋要使用的配置。
- strict
- 少數標點符號已移除,但保存變音符號與重音符號的嚴格個人設置。
- normal
- 少量標點符號、一些變音符號與停用詞被移除。
- normal-subphrases
- 少量標點符號、一些變音符號與停用詞被移除。這將會符合字詞組(可以是字詞組或取決於內部 wiki 設置的子頁面)
- fuzzy
- 與帶有錯別字糾正的正常模式相似(支援兩個錯別字)。
- fast-fuzzy
- 實驗性模糊個人設置(可能隨時移除)
- fuzzy-subphrases
- 與帶有錯別字糾正的正常模式相似(支援兩個錯別字)。這將會符合字詞組(可以是字詞組或取決於內部 wiki 設置的子頁面)
- classic
- 傳統字首、少數標點符號,以及一些變音符號已移除。
- engine_autoselect
- 讓搜尋引擎決定來使用最好的個人設置。
- 單值:classic、engine_autoselect、fast-fuzzy、fuzzy、fuzzy-subphrases、normal、normal-subphrases、strict
- 預設值:engine_autoselect
- suggest
- 已棄用。
不再使用。
- 類型:布林值(詳細資訊)
- redirects
如何處理重新導向:
- return
- 返回重新導向本身。
- resolve
- 返回目標頁面。可能返回少於limit個結果。
由於歷史原因,format=json預設為"return",其他格式預設為"resolve"。
- 單值:resolve、return
- format
輸出的格式。
- 單值:json、jsonfm、xml、xmlfm
- 預設值:json
- warningsaserror
若警告以 format=json 提升時,回傳 API 錯誤而非忽略掉。
- 類型:布林值(詳細資訊)
範例:
- 找出以 Te 為開頭的頁面。
- api.php?action=opensearch&search=Te [在沙盒中開啟]