微信小程序 小程序搜索·siteSearch

search.siteSearch

本接口應(yīng)在服務(wù)器端調(diào)用，詳細(xì)說(shuō)明參見(jiàn)服務(wù)端API。

本接口支持云調(diào)用。需開發(fā)者工具版本 >= 1.02.1904090（最新穩(wěn)定版下載）
wx-server-sdk >= 0.4.0

小程序內(nèi)部搜索API提供針對(duì)頁(yè)面的查詢能力，小程序開發(fā)者輸入搜索詞后，將返回自身小程序和搜索詞相關(guān)的頁(yè)面。因此，利用該接口，開發(fā)者可以查看指定內(nèi)容的頁(yè)面被微信平臺(tái)的收錄情況；同時(shí)，該接口也可供開發(fā)者在小程序內(nèi)應(yīng)用，給小程序用戶提供搜索能力。

調(diào)用方式：

• HTTPS 調(diào)用
• 云調(diào)用

HTTPS 調(diào)用

請(qǐng)求地址

POST https://api.weixin.qq.com/wxa/sitesearch?access_token=TOKEN

請(qǐng)求參數(shù)

返回值

Object

返回的 JSON 數(shù)據(jù)包

errcode 的合法值

items 的結(jié)構(gòu)

使用示例

curl -d '
{
    "query": "微信",
    "next_page_info": ""
}' https://api.weixin.qq.com/wxa/sitesearch?access_token=TOKEN

調(diào)用成功時(shí)的返回示例

{
    "errcode":0,
    "errmsg":"ok",
    "items": [
        {
            "title": "<em class="highlight">微信</em>版本更新！",
            "description": "...今日，<em class="highlight">微信</em>官方發(fā)布<em class="highlight">微信</em>X.Y.Z版本...",
            "image": "http://image.weixin.qq.com/1.jpeg",
            "path": "pages/normal/index?id=20191210A0C29X00"
        },
        {
            "title": "<em class="highlight">微信</em>小程序發(fā)布新功能！",
            "description": "<em class="highlight">微信</em>小程序發(fā)布了XXX功能...",
            "image": "http://image.weixin.qq.com/2.jpeg",
            "path": "pages/normal/index?id=20191210A0C29X11"
        },
    ],
    "has_next_page": 1,
    "hit_count": 100,
    "next_page_info":"eyJwYWdlX3BhcmFtIjpbeyJzdWJzeXNfdHlwZSI6MTAsInNlcnZlcl9vZmZzZXQiOjAsInNlcnZlcl9saW1pdCI6MTIwLCJpbmRleF9zdGVwIjoyMCwiaW5kZXhfb2Zmc2V0IjoyMH1dLCJjbGllbnRfb2Zmc2V0IjowLCJjbGllbnRfbGltaXQiOjEwfQ=="
}

云調(diào)用

云調(diào)用是小程序·云開發(fā)提供的在云函數(shù)中調(diào)用微信開放接口的能力，需要在云函數(shù)中通過(guò) wx-server-sdk 使用。

接口方法

openapi.search.siteSearch

需在 config.json 中配置 search.siteSearch API 的權(quán)限，詳情

請(qǐng)求參數(shù)

返回值

Object

返回的 JSON 數(shù)據(jù)包

errCode 的合法值

items 的結(jié)構(gòu)

異常

Object

拋出的異常

errCode 的合法值