MediaWiki API 說明
此頁為自動產生的 MediaWiki API 說明文件頁面。
說明文件與範例:https://www.mediawiki.org/wiki/API
action=opensearch
(main | opensearch)
- 此模組需要讀取權限。
- 来源:MediaWiki
- 许可协议:GPL-2.0-or-later
使用 OpenSearch 協定搜尋本 wiki。
參數:
- search
搜尋字串。
- 此參數為必填。
- namespace
搜尋的命名空間。
- 多值 (以 | 或 alternative 分隔):0、1、2、3、4、5、6、7、8、9、10、11、12、13、14、15、120、121、122、123、828、829、1198、1199、2300、2301、2302、2303、3000、3001、3002、3003、3004、3005、3006、3007、3008、3009、3010、3011、3012、3013、3014、3015、3016、3017、3018、3019、3020、3021
- 要指定所有值,请使用*。
- 預設值:0
- limit
回傳的結果數量上限。
- 不允許超過 500 (機器人為 5,000)。
- 类型:整数或max
- 預設值:10
- profile
搜索要使用的配置文件。
- strict
- 少數標點符號已移除,但保存變音符號與重音符號的嚴格個人設置。
- normal
- 少量標點符號、一些變音符號與停用詞被移除。
- normal-subphrases
- 少量標點符號、一些變音符號與停用詞被移除。這將會符合字詞組(可以是字詞組或取決於內部 wiki 設置的子頁面)
- fuzzy
- 與帶有錯別字糾正的正常模式相似(支援兩個錯別字)。
- fast-fuzzy
- 實驗性模糊個人設置(可隨時移除)
- fuzzy-subphrases
- 與帶有錯別字糾正的正常模式相似(支援兩個錯別字)。這將會符合字詞組(可以是字詞組或取決於內部 wiki 設置的子頁面)
- classic
- 傳統字首、少數標點符號,以及一些變音符號已移除。
- 單值:strict、normal、normal-subphrases、fuzzy、fast-fuzzy、fuzzy-subphrases、classic
- 預設值:fuzzy
- suggest
若$wgEnableOpenSearchSuggest設定為false,則不做任何事。
- 类型:布尔值(详细信息)
- redirects
如何處理重定向:
- return
- 傳回重定向本身。
- resolve
- 傳回目標頁面,傳回的結果數目可能少於limit。
由於歷史原因,format=json的預設值為「return」,其他格式則為「resolve」。
- 單值:return、resolve
- format
輸出的格式。
- 單值:json、jsonfm、xml、xmlfm
- 預設值:json
- warningsaserror
如果警告通过format=json提升,返回一个API错误而不是忽略它们。
- 类型:布尔值(详细信息)
範例:
- 查找以Te开头的页面。
- api.php?action=opensearch&search=Te [在沙盒中打开]