微信网页开发之JS-SDK初使用

article/2025/9/19 11:23:09

最近需要做一个页面,该页面使用微信浏览器打开,功能如下:

1、用户打开链接之后获取到用户的openId,用于支付、获取后台数据等场景

2、自定义分享链接、标题、图标、描述等

3、隐藏微信页面中的某些菜单项列表

阅读本文前需掌握微信公众平台开发相关基础知识。

一、准备工作

1、准备一个通过微信认证的公众号或者申请一个微信测试号,保证该公众号有“网页服务”的权限

二、开始开发

1、微信网页授权

该功能是用于获取用户相对于公众号的openId,每个用户都是唯一的。网页地址:

https://open.weixin.qq.com/connect/oauth2/authorize?appid=APPID&redirect_uri=REDIRECT_URI&response_type=code&scope=SCOPE&state=STATE#wechat_redirect

注:在微信公众号请求用户网页授权之前,开发者需要先到公众平台官网中的“开发 - 接口权限 - 网页服务 - 网页帐号 - 网页授权获取用户基本信息”的配置选项中,修改授权回调域名

该地址里面的APPID是公众号的appId,REDIRECT_URI是用户点击该网址之后跳转的地址,该地址的域名是开发者在公众平台上配置的微信网页授权回调域名。SCOPE代表授权机制,分2种,snsapi_base和snsapi_userinfo,snsapi_base只能用于获取openId,优势是静默授权,如果只需要获取用户的唯一openId的话选这个就可以;snsapi_userinfo用于获取用户信息,包括openId、头像、昵称、城市等,但这个是需要用户手动授权的,本文采用的是第一种。STATE是预留字段,这个可以随便定义值,该参数值可以传递到跳转之后的地址中。

正常情况下,用户点击上面的链接之后会跳转一个地址,该地址就是开发者配置的redirect_uri。微信会传一个参数code到该地址,开发者需要通过code获取用户信息。该code只有5分钟时效,调用如下接口:

https://api.weixin.qq.com/sns/oauth2/access_token?appid=APPID&secret=SECRET&code=CODE&grant_type=authorization_code

 

APPID和SECRET分别代表公众号的appId和秘钥,CODE是刚才传来的code,接口会返回openId和access_token,如果是snsapi_base机制,那这样就结束了,因为已经获取到openId了;如果是snsapi_userinfo机制,那还需要通过openId和access_token调用如下接口获取详细的用户信息:

https://api.weixin.qq.com/sns/userinfo?access_token=ACCESS_TOKEN&openid=OPENID&lang=zh_CN

注:如果是snsapi_userinfo机制,那access_token需要在服务器中做缓存,因为网页的access_token有效期是2小时,在有效期内都可以使用

笔者redirect_uri填写的是一个后台接口地址,在该接口中通过微信传过来的code获取用户信息,处理程序内部业务逻辑,然后再重定向到对应的html中。具体代码如下

到此,网页授权获取用户信息结束

2、微信网页中自定义分享链接、标题、图标、描述等

先登录微信公众平台进入“公众号设置”的“功能设置”里填写“JS接口安全域名”,然后在需要调用微信js的网页中引入微信的js文件http://res.wx.qq.com/open/js/jweixin-1.4.0.js

所有需要使用JS-SDK的页面必须先注入配置信息,否则将无法调用。注入配置信息的代码如下:

wx.config({debug: true, // 开启调试模式,调用的所有api的返回值会在客户端alert出来,若要查看传入的参数,可以在pc端打开,参数信息会通过log打出,仅在pc端时才会打印。appId: '', // 必填,公众号的唯一标识timestamp: , // 必填,生成签名的时间戳nonceStr: '', // 必填,生成签名的随机串signature: '',// 必填,签名jsApiList: ['onMenuShareTimeline','onMenuShareAppMessage','hideMenuItems'] // 必填,需要使用的JS接口列表
});

jsApiList为需要使用的微信JS接口列表,本文中使用到了3个接口,分别为onMenuShareTimeline(分享给好友)、onMenuShareAppMessage(分享到朋友圈)、hideMenuItems(隐藏菜单项列表)。

signature为微信签名,该签名需要在后台生成,具体签名方法如下:

a:获取jsapi_ticket。

jsapi_ticket是公众号用于调用微信JS接口的临时票据,jsapi_ticket需要调用如下接口获取https://api.weixin.qq.com/cgi-bin/ticket/getticket?access_token=ACCESS_TOKEN&type=jsapi,其中ACCESS_TOKEN是公众号的全局access_token,获取access_token方法详见微信公众平台开发文档,本文不再赘述。jsapi_ticket有效期为2小时,开发者需要在服务器端缓存jsapi_ticket。

b:对请求参数进行排序拼装。

参与签名的字段包括noncestr(随机字符串), 有效的jsapi_ticket, timestamp(时间戳,精确到秒), url(当前网页的URL,不包含#及其后面部分) 。对所有待签名参数按照字段名的ASCII 码从小到大排序(字典序)后,使用URL键值对的格式(即key1=value1&key2=value2…)拼接成字符串string1。这里需要注意的是所有参数名均为小写字符。对string1作sha1加密,字段名和字段值都采用原始值,不进行URL 转义

即signature=sha1(string1)。 请求参数示例:

noncestr=Wm3WZYTPz0wzccnW
jsapi_ticket=sM4AOVdWfPE4DxkXGEs8VMCPGGVi4C3VM0P37wVUCFvkVAy_90u5h9nbSlYy3-Sl-HhTdfl2fzFy1AOcHKP7qg
timestamp=1414587457
url=http://mp.weixin.qq.com?params=value

步骤1. 对所有待签名参数按照字段名的ASCII 码从小到大排序(字典序)后,使用URL键值对的格式(即key1=value1&key2=value2…)拼接成字符串string1:

jsapi_ticket=sM4AOVdWfPE4DxkXGEs8VMCPGGVi4C3VM0P37wVUCFvkVAy_90u5h9nbSlYy3-Sl-HhTdfl2fzFy1AOcHKP7qg&noncestr=Wm3WZYTPz0wzccnW&timestamp=1414587457&url=http://mp.weixin.qq.com?params=value

步骤2. 对string1进行sha1签名,得到signature:

0f9de62fce790f9a083d5c99e95740ceb90c27ed

后台接口将noncestr、timestamp、jsapi_ticket、signature返回,然后前台js将这些参数值用于注入配置信息。本文实现如下:

通过ready接口处理成功验证

wx.ready(function(){var shareData = {title: '银座洗车年终钜惠', //	标题desc: '抢购优惠洗车资格,腊月二十七放假前均可使用', //	描述link: 'http://xxx.html', //	分享的URL,域名为授权域名imgUrl: 'http://xxxxx.png' //	缩略图地址};wx.onMenuShareAppMessage(shareData);wx.onMenuShareTimeline(shareData);wx.hideMenuItems({menuList: ['menuItem:copyUrl'] // 要隐藏的菜单项});});

配置信息注入成功之后,需要通过ready接口处理成功验证。上面的js完成2个功能。一个是分享该页面给好友或者朋友圈时自定义标题、链接、图标等,另一个是菜单项中去掉“复制链接”按钮。

通过error接口处理失败验证

wx.error(function(res){// config信息验证失败会执行error函数,如签名过期导致验证失败,具体错误信息可以打开config的debug模式查看,也可以在返回的res参数中查看,对于SPA可以在这里更新签名。
});

到此,文中开题描述的3个功能已完成,总体来说有2个注意的地方

1、网页授权的openId需要通过微信的code来获取,这个code只有5分钟的失效,如果需要获取用户详细信息还要通过openId和access_token来调接口获得

2、需要使用JS-SDK的页面必须先注入配置信息,注入配置信息过程中会遇到微信签名问题,需要熟悉微信签名算法。同时为了安全,这个签名需要在后台完成。

完成后效果如下:

自定义分享标题、链接、图标等

菜单项里面的“复制链接”按钮没有了

如有疑问,可关注公众号留言,工程师将尽快回答您的问题。公众号二维码:

                                        

最后,打波广告。微信搜索公众号"购即省",淘宝购物领券,购物即省钱。


http://chatgpt.dhexx.cn/article/HAYrQ428.shtml

相关文章

微信网页开发--获取微信用户信息

流程 用户扫码或者直接点击链接进入我们的入口页面;进入授权登录页面,用户点击授权登录按钮;微信会自动将我么的网页授权域名后增加参数;根据微信给的code去获取当前登录的微信用户的用户信息。 具体操作过程 1.配置网页授权域名…

微信网页开发(4)--使用JSSDK基础接口

点此查看 微信公众号/微信网页/微信支付/企业微信/小程序开发合集及源代码下载 本文目录 1. JSSDK接口2. 基础接口3. 开发流程3.1 绑定域名3.2 引入JS文件3.3 通过config接口注入权限验证配置3.5 调用基础接口 4. 小结 1. JSSDK接口 微信提供了很多JSSDK接口,包括基…

微信网页开发(8)--地理位置接口

点此查看 微信公众号/微信网页/微信支付/企业微信/小程序开发合集及源代码下载 本文目录 1. 背景2. 代码3. 测试 1. 背景 微信网页提供了获取当前地理位置经纬度,以及通过内置地图查看当前位置的接口。 官方接口说明如下: // 获取位置 wx.getLocation…

微信公众号开发——2、微信网页开发

第一部分、为公众号菜单嵌入网页 一、关键参考文档 微信JS-SDK说明文档 。 二、编辑模式嵌入网页 在公众号平台下,自定义菜单,添加菜单,并选择菜单内容跳转到指定页面地址即可(需认证后方可添加页面地址,个人账号暂不…

微信网页开发配置整理

真是人越大记忆越差,断断续续做了几个微信小程序和微信h5项目,然鹅小程序的开发流程有些都忘了,最近刚做完一个微信h5网页开发的项目,所以赶紧记录下开发中需要注意的点,给自己往后回顾,同时也给第一次接入…

微信网页开发调试的一些方法

1. 微信开发者工具调试 微信开发者工具下载 不过多介绍, 下载安装, 就能开始小程序开发和公众号网页开发. 2. 微信内自带调试 微信内打开网页 http://debugx5.qq.com (仅支持Android微信) 打开下面两项,就可以调试了 3. 使用vConsole插件 1. 下载vConsole插件…

前端对接微信公众号网页开发流程,前期配置

微信公众号网页开发,其实就是我们开发的h5网页需要放到微信浏览器环境中使用,但是需要对接公众号授权,授权之后可以获取到用户的个人信息,以及可以使用公众号提供的一些API,如:图片上传、图片预览、获取位置信息、微信…

微信网页开发(3)--微信网页授权

点此查看 微信公众号/微信网页/微信支付/企业微信/小程序开发合集及源代码下载 本文目录 1. 什么是授权2. 两种授权方式3. 网页授权access_token和普通access_token4. 网页授权流程5. 网页授权代码开发5.1 项目搭建5.2 修改配置文件5.3 开发启动类5.4 开发公众号配置类5.5 开发…

微信网页开发:微信内h5使用wx-open-launch-weapp打开小程序,微信内h5使用wx-open-launch-app打开App的方案

需求场景: 当我们需要使用在微信客户端打开的h5页面,在页面上打开微信小程序或者唤起App时,我们需要使用微信js-sdk提供的开放标签能力。这其中:使用wx-open-launch-weapp标签打开微信小程序;使用wx-open-launch-app跳…

算法分析与设计 二分查找

算法分析与设计 二分查找 二分查找的基本概念 ​ 二分查找是一种在有序数组中查找某一特定元素的查找算法。这种查找方法将查找的时间复杂度从原本的线性时间提升到了对数时间范围,大大缩短了搜索时间。 ​ 二分查找的基本思想是:在查找过程从数组的中…

C语言二分查找

我们常常需要对数据进行查找,修改,查找数据有许多方法,我们先看看最简单的顺序查找 int main() {int i, k 0;scanf("%d", &k);int arr[] { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 };int sz sizeof(arr) / sizeof(arr[0]);for (i…

二分查找【详解】

本期介绍🍖 主要介绍:二分查找的简单思路,为什么必须在有序的前提下才能使用二分查找,该怎么用C程序来实现二分查找,二分查找的局限性👀。 目录🍖 简单思路前提条件编写程序总结 简单思路&…

二分答案

二分答案 总所周知,二分法查找一个数的时间复杂度为O(log n),所以在int范围内找一个数最多只需要30余次,在longlong范围内最多也只需要60余次。因此,我们可以利用二分这一优势查找答案。即,每次二分后判断该数是不是满…

初探二分算法

又来算法了~~~~ 😃😃😆😆😃😃😃😆😆😆👀👀😆🤔 什么是二分算法? 在计算机科学中,二分…

二分(数学背景,边界问题,二分查找,二分答案)

二分法的数学背景 目的 关于二分法的目的,这里引用同济大学数学系出版的《高等数学》第七版上册中关于二分法的相关内容。(文段内容多,要有一点耐心~) 在科学技术问题中,经常会遇到 求解高次代数方程或其他类型的方程的…

二分模板介绍

以一个典型例题来介绍二分法的两个通用模板,熟练掌握这两个模板可以解决绝大部分二分的问题。 例题:ACWing 789.数的范围 给定一个按照升序排列的长度为n的整数数组,以及q个查询。 对于每个查询,返回一个元素k的起始位置和终止…

二分算法详细解析

二分 有单调性一定可以二分,可以二分不一定有单调性二分的本质是边界不是单调性(单调一定可以二分,不单调的有的也可以二分) 本质:在一个区间上,找到某种性质,每次可以将区间一分为二(存在边界)…

一篇文章带你搞懂二分

一篇文章教你搞懂二分 二分整数二分实数域上二分二分查找二分答案 二分 到底什么是二分呢?二分二分就是一分为二。简单来说二分就是在有序序列中,通过不断的二分,进而不断地缩小范围去寻找满足我们条件的解。这只是对二分一个狭义上的理解&a…

深入字节版atop: 线上系统的性能监控实践

背景 atop 是一款开源的单机性能监测工具,支持实时观测的同时、也支持读取历史文件排查问题。另外一个优点是除提供 CPU、MEM、DISK 等全局指标外,还提供进程、线程级别的各项指标监控数据。鉴于 atop 的这些优点,字节跳动基于社区的 atop 进…

atop备忘

atop 安装 sudo apt install atop atop 参数说明 监控界面字段说明 ATOP列:该列显示了主机名、信息采样日期和时间点 PRC列:该列显示进程整体运行情况 sys、usr字段分别指示进程在内核态和用户态的运行时间 #proc字段指示进程总数 #zombie字段指示僵…