Next-Generation WeChat JS-SDK integration with NodeJS(node >= 4), with support for web OAuth to retrieve wechat user profile.
For v2.x(node >= 0.10), pls checkout the Readme on v2.x
npm install wechat-jssdk --save
const Wechat = require('wechat-jssdk');
const wx = new Wechat(wechatConfig);
Required wechatConfig
info:
{
//set your oauth redirect url, defaults to localhost
"wechatRedirectUrl": "http://yourdomain.com/wechat/oauth-callback",
"wechatToken": "wechat_token",
"appId": "appid",
"appSecret": "app_secret",
}
For other url configuration, there are default values, you can checkout the ./lib/config.js
.
1.Set your URL and Token in Wechat Website
you should provide a api(e.g /api/wechat
) to let wechat verify your validation,
for example, in your router:
const Wechat = require('wechat-jssdk');
const wx = new Wechat(wechatConfig);
router.get('/api/wechat', function(req, res){
if(wx.jssdk.verifySignature(req.query)) {
res.send(req.query.echostr);
return;
}
res.send("error");
});
if everything is OK, wechat will save your settings :).
But usually wechat will provide you a MP_verify_XHZon7GAGRdcAFxx.txt
like file to ask you to put that on your website root,
which will be accessed by wechat on http://yourdomain.com/MP_verify_XHZon7GAGRdcAFxx.txt
to verify that you own the domain.
2.You should also provide a api for your browser to get token for the current url
router.get('/get-signature', function(req, res) {
wx.jssdk.getSignature(req.query.url).then(function(signatureData) {
res.json(signatureDate);
});
});
3.Now you can send the wx request in your browser to pass the verification.
var WechatJSSDK = require('wechat-jssdk/dist/client.min')
in your client side js, or any other way you like to include this.
var wechatObj = new WechatJSSDK(config)
or in traditional environment, use the prebuilt ./dist/client.min.js
:
var wechatObj = new window.WechatJSSDK(config)
where config will be:
var config = {
//below are mandatory options to finish the wechat signature verification
'appId': 'app_id',
//the 3 options below should be received like api '/get-signature' above
'nonceStr': 'your_nonceStr',
'signature': 'url_signature',
'timestamp': 'your_timestamp',
//below are optional
//invoked if wechat signature sign succeeds
'success': function(){},
//invoked if sign failed
'error': function(err){},
//enable debug mode, same as debug
'debug': true,
'jsApiList': [], //optional, pass all the jsapi you want, the default will be ['onMenuShareTimeline', 'onMenuShareAppMessage']
'customUrl': '' //set custom weixin js script url, usually you don't need to add this js manually
}
after signature signed successfully, you can customize the share information:
//customize share on chat info
//sugar method for `wechatObj.callWechatApi('onMenuShareAppMessage', {...})`
wechatObj.shareOnChat({
type: 'link',
title: 'title',
link: location.href,
imgUrl: '/logo.png',
desc: 'description',
success: function (){},
cancel: function (){}
});
//customize share on timeline info
//sugar method
wechatObj.shareOnMoment({
type: 'link',
title: 'title',
link: location.href,
imgUrl: '/logo.png'
});
You can also access the original wechat object wx
from window.wx
or from wechatObj.wx
to call other apis.
Also you can update the sign config if it fails, pass the new must has configs to wechatObj.signSignature(newSignatureConfig)
.
newSignatureConfig
should only has:
{
'nonceStr': 'xxx',
'signature': 'xxx',
'timestamp': 'xxx',
}
Call other wechat apis: wechatObj.callWechatApi(apiName, config)
:
wechatObj.callWechatApi('onMenuShareAppMessage', {
type: 'link',
title: 'title',
link: location.href,
imgUrl: '/logo.png',
desc: 'description',
success: function (){},
cancel: function (){}
});
Wechat support web OAuth to get user profile in wechat app.
In your page, provide a link, which you can get by wx.oauth.snsUserInfoUrl
which is the default oauth url, to the wechat OAuth page,
also you need provide a callback url(as show below) to get the wechat code after user click Agree button, the callback url is configured in the wechatConfig
object above while initializing,
but you can customize your own callback url by using wx.oauth.generateOAuthUrl(customUrl, scope, state)
api.
//default callback url
router.get('/wechat/oauth-callback', function (req, res) {
wx.oauth.getUserInfo(req.query.code)
.then(function(userProfile) {
console.log(userProfile)
res.render("demo", {
wechatInfo: userProfile
});
});
});
New in V3
Store are used to save url signatures into files, dbs, etc..., but also keep a copy in memory for better performence.
The default store used is FileStore
which will persist tokens and signatures into wechat-info.json
file every 10 minutes, also it will load these info from the file in next initialization.
Built in Stores: FileStore
, MongoStore
,
...
const Wechat = require('wechat-jssdk');
const MongoStore = Wechat.MongoStore;
const FileStore = Wechat.FileStore;
const wx = new Wechat({
appId: 'xxx',
...,
//file store
//store: new FileStore(),
//======
//pass the MongoStore instance to config
//default 127.0.0.1:27017/wechat db, no need to pass anything to constructor
store: new MongoStore({
//dbName: 'myWechat', //default wechat
dbAddress: 'mongodb://127.0.0.1:27017/wechat', //set the whole connection uri by yourself
dbOptions: {}, //set mongoose connection config
})
})
You can also create own Store to store tokens anywhere you want, by doing that, you may need to extend the base Store
class, and reimplement the apis you need(take a look at Store.js):
const Store = require('wechat-jssdk').Store;
class CustomStore extends Store {
constructor (options) {
super();
console.log('using my own store!');
}
}
see API wiki
Use your own appId
and appSecret
in ./demo/index.js
to test
Use npm start
to start the demo.
MIT