创新互联小程序教程:微信小程序 小程序搜索·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

请求参数

属性类型默认值必填说明
access_tokenstring接口调用凭证
keywordstring关键词
next_page_infostring请求下一页的参数,开发者无需理解。为空时查询的是第一页内容,如需查询下一页,把返回参数的next_page_info填充到这里即可

返回值

Object

返回的 JSON 数据包

属性类型说明
errcodestring错误码
errmsgstring错误信息
itemsArray.搜索结果列表
has_next_pageboolean是否有下一页
next_page_infostring请求下一页的参数,开发者无需理解,如需查询下一页结果,把该参数填充到下页请求参数中的next_page_info即可
hit_countnumber估算索引文档数

errcode 的合法值

说明最低版本
-1系统繁忙,此时请开发者稍候再试
47101搜索结果总数超过了1000条
47102next_page_info参数错误

items 的结构

属性类型说明
titlestring小程序页面标题
descriptionstring小程序页面摘要
imagestring小程序页面代表图
pathstring小程序页面路径

使用示例

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

调用成功时的返回示例

{
    "errcode":0,
    "errmsg":"ok",
    "items": [
        {
            "title": "微信版本更新!",
            "description": "...今日,微信官方发布微信X.Y.Z版本...",
            "image": "http://image.weixin.qq.com/1.jpeg",
            "path": "pages/normal/index?id=20191210A0C29X00"
        },
        {
            "title": "微信小程序发布新功能!",
            "description": "微信小程序发布了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 的权限, 详情

请求参数

属性类型默认值必填说明
keywordstring关键词
nextPageInfostring请求下一页的参数,开发者无需理解。为空时查询的是第一页内容,如需查询下一页,把返回参数的next_page_info填充到这里即可

返回值

Object

返回的 JSON 数据包

属性类型说明
errCodestring错误码
errMsgstring错误信息
itemsArray.搜索结果列表
hasNextPageboolean是否有下一页
nextPageInfostring请求下一页的参数,开发者无需理解,如需查询下一页结果,把该参数填充到下页请求参数中的next_page_info即可
hitCountnumber估算索引文档数

errCode 的合法值

说明最低版本
0成功

items 的结构

属性类型说明
titlestring小程序页面标题
descriptionstring小程序页面摘要
imagestring小程序页面代表图
pathstring小程序页面路径

异常

Object

抛出的异常

属性类型说明
errCodestring错误码
errMsgstring错误信息

errCode 的合法值

说明最低版本
-1系统繁忙,此时请开发者稍候再试
47101搜索结果总数超过了1000条
47102next_page_info参数错误

网站题目:创新互联小程序教程:微信小程序 小程序搜索·siteSearch
本文路径:http://www.gawzjz.com/qtweb2/news31/18681.html

网站建设、网络推广公司-创新互联,是专注品牌与效果的网站制作,网络营销seo公司;服务项目有等

广告

声明:本网站发布的内容(图片、视频和文字)以用户投稿、用户转载内容为主,如果涉及侵权请尽快告知,我们将会在第一时间删除。文章观点不代表本网站立场,如需处理请联系客服。电话:028-86922220;邮箱:631063699@qq.com。内容未经允许不得转载,或转载时需注明来源: 创新互联