微信公眾號JS-SDK使用具體實現(xiàn)
先看下微信官網(wǎng)的JS-SDK介紹
前期準備
- 微信測試公眾號
- 內(nèi)網(wǎng)穿透
- 服務端程序
上面這三個東西能簡單介紹下,微信測試公眾號是用來給本地開發(fā)測試微信接口用的;內(nèi)網(wǎng)穿透是因為微信的回調(diào)接口、校驗接口、js安全域名都是用的公網(wǎng)ip或者域名(線上只能用域名);服務端程序是用來處理一些存儲的問題;
具體實現(xiàn)
微信測試公眾號配置
下面是具體的配置和需要注意的地方,特別注意就是js安全域名和頁面調(diào)用wx.config的域名需要是同一個


服務端程序配置
后端是springboot, 用的wxJava工具類便捷請求,也可以用JS-SDK介紹的附錄1-JS-SDK使用權(quán)限簽名算法替換
具體代碼如下
import lombok.RequiredArgsConstructor;
import me.chanjar.weixin.common.bean.WxJsapiSignature;
import me.chanjar.weixin.common.error.WxErrorException;
import me.chanjar.weixin.mp.api.WxMpService;
import org.springframework.web.bind.annotation.*;
/**
* 微信功能控制器
*/
@RestController
@RequiredArgsConstructor
@RequestMapping(value = "/wx")
public class WxController {
private final WxMpService wxService;
/**
* 校驗指定公眾號的簽名
* 設置URL和TOKEN時,微信服務器會發(fā)送GET請求到該地址,并攜帶參數(shù)
* 請求方向:wx---》業(yè)務系統(tǒng)
* URL: http://{host:port或domain}/wx/{appId}/checkSignature
* @param appId 公眾號appId
* @param signature 微信加密簽名,signature結(jié)合了開發(fā)者填寫的token參數(shù)和請求中的timestamp參數(shù)、nonce參數(shù)。
* @param timestamp 時間戳
* @param nonce 隨機數(shù)
* @param echostr 隨機字符串
* @return echostr或者空, 如果返回echostr,則說明校驗通過,否則不通過
*/
@GetMapping("/{appId}/checkSignature")
public String checkSignature(
@PathVariable(value = "appId") String appId,
@RequestParam(value = "signature") String signature,
@RequestParam(value = "timestamp")String timestamp,
@RequestParam(value = "nonce")String nonce,
@RequestParam(value = "echostr")String echostr) {
boolean flag = this.wxService.switchoverTo(appId).checkSignature(timestamp, nonce, signature);
return flag ? echostr : "";
}
/**
* 獲取JS-SDK所需要的簽名參數(shù)
* @param appId 公眾號的應用Id
* @param pageUrl 前端的訪問地址
* @return 返回值 如{"code": 200, "data": {"appid": "", "nonceStr": "", "timestamp": 0, "url": "", "signature": ""}}
*/
@GetMapping("/{appId}/jsapi/getJsapiTicket")
public AjaxResult<WxJsapiSignature, Object> getJsapiTicket(
@PathVariable(value = "appId") String appId,
@RequestParam(value = "pageUrl") String pageUrl) throws WxErrorException {
final WxJsapiSignature jsapiSignature = this.wxService.switchoverTo(appId).createJsapiSignature(pageUrl);
return AjaxResult.success(jsapiSignature);
}
}前端配置
安裝weixin-js-sdk
npm install weixin-js-sdk
寫一個工具類,傳入/jsapi/getJsapiTicket接口的返回值
import wx from 'weixin-js-sdk';
export const wxConfig = async (params) => {
const {appId, timestamp, nonceStr, signature} = params;
wx.config({
debug: true, // 開啟調(diào)試模式,調(diào)用的所有api的返回值會在客戶端alert出來,若要查看傳入的參數(shù),可以在pc端打開,參數(shù)信息會通過log打出,僅在pc端時才會打印。
appId: appId, // 必填,公眾號的唯一標識
timestamp: Number(timestamp), // 必填,生成簽名的時間戳
nonceStr: nonceStr, // 必填,生成簽名的隨機串
signature: signature,// 必填,簽名
jsApiList: ['scanQRCode'] // 必填,需要使用的JS接口列表
});
wx.ready(function(){
wx.checkJsApi({
jsApiList: ['chooseImage', 'scanQRCode'], // 需要檢測的JS接口列表,所有JS接口列表見附錄2,
success: function(res) {
console.log(res.checkResult);
// 以鍵值對的形式返回,可用的api值true,不可用為false
// 如:{"checkResult":{"chooseImage":true},"errMsg":"checkJsApi:ok"}
}
});
// config信息驗證后會執(zhí)行ready方法,所有接口調(diào)用都必須在config接口獲得結(jié)果之后,config是一個客戶端的異步操作,所以如果需要在頁面加載時就調(diào)用相關(guān)接口,則須把相關(guān)接口放在ready函數(shù)中調(diào)用來確保正確執(zhí)行。對于用戶觸發(fā)時才調(diào)用的接口,則可以直接調(diào)用,不需要放在ready函數(shù)中。
});
wx.error(function(res){
console.log(res)
// config信息驗證失敗會執(zhí)行error函數(shù),如簽名過期導致驗證失敗,具體錯誤信息可以打開config的debug模式查看,也可以在返回的res參數(shù)中查看,對于SPA可以在這里更新簽名。
});
}
調(diào)用方法
!!!最容易出錯的就是這個pageUrl, 如果wx.config 報錯:config:fail,invalid signature? 一定要檢查下這個,絕大部分就是這個錯微信要求調(diào)用wx.config的這個頁面和你獲取參數(shù)請求傳的url一定要一樣。所以這個pageUrl在前端傳給后端,后端拿著這個去請求微信獲取簽名參數(shù)。
// 如http://${js安全域名}/#/devtoolUi/pages/index/index 轉(zhuǎn)為http://${js安全域名}/ ,注意最后的/不能缺,有?param=xxx也要包含
let pageUrl = location.href.split('#')[0];
// 請求后端接口獲取配置信息
request({
url:`wx/${userConfig.option.devtoolUi.wx.h5.appid}/jsapi/getJsapiTicket?pageUrl=${pageUrl}`,
method: 'GET',
header: {}
}).then((res) => {
if (res.code === 200) {
// console.log('獲取配置信息成功', res)
wxConfig(res.data);
}
});
如果想要知道自己的參數(shù)對不對可以用這個微信 JS 接口簽名校驗工具
附錄
js獲取簽名參數(shù)方法
1.獲取token
GET https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=APPID&secret=APPSECRET
2.獲取tticket
https://api.weixin.qq.com/cgi-bin/ticket/getticket?access_token=ACCESS_TOKEN&type=jsapi
3.獲取簽名參數(shù)
noncestr=Wm3WZYTPz0wzccnW(自擬的隨機字符串)
jsapi_ticket=sM4AOVdWfPE4DxkXGEs8VMCPGGVi4C3VM0P37wVUCFvkVAy_90u5h9nbSlYy3-Sl-HhTdfl2fzFy1AOcHKP7qg(步驟二所得)
timestamp=1414587457(事件字符串)
url=http://mp.weixin.qq.com?params=value(前端當前訪問的url)
對所有待簽名參數(shù)按照字段名的ASCII 碼從小到大排序(字典序)后,使用URL鍵值對的格式(即key1=value1&key2=value2…)拼接成字符串
得到下面字符串
jsapi_ticket=sM4AOVdWfPE4DxkXGEs8VMCPGGVi4C3VM0P37wVUCFvkVAy_90u5h9nbSlYy3-Sl-HhTdfl2fzFy1AOcHKP7qg&noncestr=Wm3WZYTPz0wzccnW×tamp=1414587457&url=http://mp.weixin.qq.com?params=value
進行sha1簽名,得到signature:0f9de62fce790f9a083d5c99e95740ceb90c27ed
const CryptoJS = require("crypto-js");
// 待加密的數(shù)據(jù)
const data = "Hello, World!";
// 使用SHA-1算法加密
const hash = CryptoJS.SHA1(data);
總結(jié)
到此這篇關(guān)于微信公眾號JS-SDK使用具體實現(xiàn)的文章就介紹到這了,更多相關(guān)微信公眾號JS-SDK使用內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家!
相關(guān)文章
Javascript中實現(xiàn)trim()函數(shù)的兩種方法
這篇文章主要介紹了Javascript中實現(xiàn)trim()函數(shù)的兩種方法,本文直接給出實現(xiàn)代碼和使用方法,需要的朋友可以參考下2015-02-02
Electron去掉窗口邊框并添加關(guān)閉按鈕的實現(xiàn)步驟
在?Electron?中,如果你想去掉默認的窗口邊框(frame)并添加額外的按鍵,可以通過相關(guān)步驟實現(xiàn),下面小編給大家?guī)砹薊lectron去掉窗口邊框并添加關(guān)閉按鈕的實現(xiàn)步驟,感興趣的朋友一起看看吧2024-06-06
JavaScript中null和undefined的區(qū)別詳解
null 是一個原始值,表示“無”或“空值”,它通常用于指示變量應有的對象或值不存在,undefined 是一個原始值,表示“未定義”,本文給大家詳細介紹了JavaScript中null和undefined的區(qū)別,需要的朋友可以參考下2024-10-10
Gulp實現(xiàn)靜態(tài)網(wǎng)頁模塊化的方法詳解
眾所周知Gulp.js 是一個自動化構(gòu)建工具,開發(fā)者可以使用它在項目開發(fā)過程中自動執(zhí)行常見任務。下面這篇文章主要給大家介紹了關(guān)于Gulp實現(xiàn)靜態(tài)網(wǎng)頁模塊化的相關(guān)資料,文中通過示例代碼介紹的非常詳細,需要的朋友可以參考下。2018-01-01

