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

search.siteSearch

本接口应在服务器端调用，详细说明参见服务端API。

本接口支持云调用。需开发者工具版本 >= 1.02.1904090（最新稳定版下载）
wx-server-sdk >= 0.4.0

小程序内部搜索API提供针对页面的查询能力，小程序开发者输入搜索词后，将返回自身小程序和搜索词相关的页面。因此，利用该接口，开发者可以查看指定内容的页面被微信平台的收录情况；同时，该接口也可供开发者在小程序内应用，给小程序用户提供搜索能力。

调用方式：

• HTTPS 调用
• 云调用

HTTPS 调用

请求地址

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

请求参数

返回值

Object

返回的 JSON 数据包

errcode 的合法值

items 的结构

使用示例

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

调用成功时的返回示例

{
    "errcode":0,
    "errmsg":"ok",
    "items": [
        {
            "title": "<em class="highlight">微信</em>版本更新！",
            "description": "...今日，<em class="highlight">微信</em>官方发布<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>小程序发布新功能！",
            "description": "<em class="highlight">微信</em>小程序发布了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=="
}

云调用

云调用是小程序·云开发提供的在云函数中调用微信开放接口的能力，需要在云函数中通过 wx-server-sdk 使用。

接口方法

openapi.search.siteSearch

需在 config.json 中配置 search.siteSearch API 的权限，详情

请求参数

返回值

Object

返回的 JSON 数据包

errCode 的合法值

items 的结构

异常

Object

抛出的异常

errCode 的合法值