API:ค้นหา
Outdated translations are marked like this.
This page is part of the MediaWiki Action API documentation. |
เวอร์ชันมีเดียวิกิ: | ≥ 1.11 |
รับคำขอ เพื่อค้นหาชื่อเรื่องหรือข้อความในวิกิ
เอกสาร API
รับคำขอ
api.php? action=query& list=search& srsearch=Nelson%20Mandela& utf8=& format=json [ลองใช้ในกระบะทรายเอพีไอ]
ผลการค้นหาเริ่มต้นจะไม่มีการเข้ารหัส UTF8 แทนที่
utf8
ในคำขอรับด้านบนเพื่อดูความแตกต่าง
การตอบรับ
{
"batchcomplete": "",
"continue": {
"sroffset": 10,
"continue": "-||"
},
"query": {
"searchinfo": {
"totalhits": 5060
},
"search": [
{
"ns": 0,
"title": "Nelson Mandela",
"pageid": 21492751,
"size": 196026,
"wordcount": 23664,
"snippet": "<span class=\"searchmatch\">Nelson</span> Rolihlahla <span class=\"searchmatch\">Mandela</span> (/mænˈdɛlə/, Xhosa: [xoliɬaˈɬa <span class=\"searchmatch\">manˈdɛla</span>]; 18 July 1918 – 5 December 2013) was a South African anti-apartheid revolutionary,",
"timestamp": "2018-07-23T07:59:43Z"
},
{
"ns": 0,
"title": "Death of Nelson Mandela",
"pageid": 41284488,
"size": 133513,
"wordcount": 13512,
"snippet": "On December 5, 2013, <span class=\"searchmatch\">Nelson</span> <span class=\"searchmatch\">Mandela</span>, the first President of South Africa to be elected in a fully representative democratic election, as well as the country's",
"timestamp": "2018-07-19T17:30:59Z"
}
...
]
}
}
รหัสตัวอย่าง
Python
#!/usr/bin/python3
"""
search.py
MediaWiki API Demos
Demo of `Search` module: Search for a text or title
MIT License
"""
import requests
S = requests.Session()
URL = "https://en.wikipedia.org/w/api.php"
SEARCHPAGE = "Nelson Mandela"
PARAMS = {
"action": "query",
"format": "json",
"list": "search",
"srsearch": SEARCHPAGE
}
R = S.get(url=URL, params=PARAMS)
DATA = R.json()
if DATA['query']['search'][0]['title'] == SEARCHPAGE:
print("Your search page '" + SEARCHPAGE + "' exists on English Wikipedia")
PHP
<?php
/*
search.php
MediaWiki API Demos
Demo of `Search` module: Search for a text or title
MIT License
*/
$searchPage = "Nelson Mandela";
$endPoint = "https://en.wikipedia.org/w/api.php";
$params = [
"action" => "query",
"list" => "search",
"srsearch" => $searchPage,
"format" => "json"
];
$url = $endPoint . "?" . http_build_query( $params );
$ch = curl_init( $url );
curl_setopt( $ch, CURLOPT_RETURNTRANSFER, true );
$output = curl_exec( $ch );
curl_close( $ch );
$result = json_decode( $output, true );
if ($result['query']['search'][0]['title'] == $searchPage){
echo("Your search page '" . $searchPage . "' exists on English Wikipedia" . "\n" );
}
JavaScript
/*
search.js
MediaWiki API Demos
Demo of `Search` module: Search for a text or title
MIT License
*/
var url = "https://en.wikipedia.org/w/api.php";
var params = new URLSearchParams({
action: "query",
list: "search",
srsearch: "Nelson Mandela",
format: "json",
origin: location.origin
});
fetch(`${url}?${params}`)
.then(function(response){return response.json();})
.then(function(response) {
if (response.query.search[0].title === "Nelson Mandela"){
console.log("Your search page 'Nelson Mandela' exists on English Wikipedia" );
}
})
.catch(function(error){console.log(error);});
MediaWiki JS
/*
search.js
MediaWiki API Demos
Demo of `Search` module: Search for a text or title
MIT License
*/
var params = {
action: 'query',
list: 'search',
srsearch: 'Nelson Mandela',
format: 'json'
},
api = new mw.Api();
api.get( params ).done( function ( data ) {
if ( data.query.search[ 0 ].title === 'Nelson Mandela' ) {
console.log( "Your search page 'Nelson Mandela' exists on English Wikipedia" );
}
} );
ข้อบกพร่องที่อาจเกิด
รหัส | ข้อมูล |
---|---|
nosrsearch | The srsearch parameter must be set. นี่คือการค้นหาแบบพารามิเตอร์ก่อน 1.17
|
search-text-disabled | text search is disabled. |
search-title-disabled | title search is disabled. |
search-error | ได้พบข้อบกพร่อง |
ประวัติพารามิเตอร์
- v1.24: Deprecated
score
,hasrelated
- v1.23:
- Removed
srredirects
. Redirects are always included. - Introduced
srinterwiki
- Removed
- v1.22: Introduced
srbackend
- v1.17: Introduced
nearmatch
,score
,titlesnippet
,redirecttitle
,redirectsnippet
,sectiontitle
,sectionsnippet
,hasrelated
- v1.16: Introduced
srinfo
,srprop
หมายเหตุเพิ่มเติม
- ทั้งนี้ขึ้นอยู่กับการใช้แบ็กเอนด์การค้นหาวิธีการตีความ
srsearch
อาจแตกต่างกันไป
ใน Wikimedia wikis ที่ใช้ CirrusSearch ดู วิธีใช้งาน:CirrusSearch สำหรับข้อมูลเกี่ยวกับไวยากรณ์การค้นหา