mp-sdk-rojer

比官方 SDK 更好用的微信小程序服务器端 SDK。

此包修改自原作者willin的mp-sdk，完善了一些接口与token的同一管理功能。

已经疯狂得不能用代码行数（总计89行，包含空行和 debug）来衡量该项目了，代码仅有 1,310字节（净化后）。

Minimum, Flexible, Scalable.

支持 Lazy Require。

• 安装使用
  • 基本使用示例
  • 二维码处理示例
  • 解密示例
• 参考文档
• 相关项目推荐
• License

安装使用

yarn add mp-sdk-rojer
# 或
npm i --save mp-sdk-rojer

基本使用示例

const sdk = require("mp-sdk-rojer");

const cloud = sdk("appid", "secret");

// appid、secret、access_token、grant_type 4个字段可以忽略不写
cloud.auth
  .code2Session({
    js_code: "js_code"
  })
  .then(result => {
    // code here
  });

二维码处理示例

const sdk = require("mp-sdk-rojer");
const fs = require("fs");

const cloud = sdk("appid", "secret");

cloud.wxacode
  .getUnlimited({
    scene: "test",
    path: "page/index?foo=bar"
  })
  .then(d => {
    fs.writeFileSync("1.png", d);
  });

解密示例

本 SDK 中加入解密方法 .crypto.decryptData。

传入一个对象，包含以下三个参数：

• sessionKey： 登录会话的凭证
• encryptedData： 密文数据
• iv：初始化向量

以上三个字段均为必须，在微信开发者文档中也有具体的说明。

const sdk = require("mp-sdk-rojer");
const cloud = sdk(
  "appid",
  "secret",
  async () => {
    return {}; // 这里你应该返回 token
  },
  async value => {
    // 这里你应该保存 token
  }
);

// 注意： 该方法并不放回 Promise 而是直接返回解密结果。
const result = cloud.crypto.decryptData({
  sessionKey: "xxx",
  encryptedData: "xxx",
  iv: "xxx"
});

console.log(result);
// 可能结果如下： watermark 对象用作校验，具体请参考文档
// {
//   phoneNumber: 'xxxx',
//   purePhoneNumber: 'xxx',
//   countryCode: 'xxxx',
//   watermark: { timestamp: 1560502778, appid: 'wxc0783c8b8bfef8d3' }
// }

参考文档

• 接口文档： https://developers.weixin.qq.com/miniprogram/dev/api-backend/
• 登录（sessionKey 获取）： https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/login.html
• 数据加密解密： https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/signature.html
• 小程序端授权： https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/authorize.html

相关项目推荐

• 阿里云 SDK： https://github.com/willin/waliyun
• 腾讯云 SDK： https://github.com/willin/wqcloud
• 网易云音乐 SDK： https://github.com/willin/wnm
• Rescuetime SDK： https://github.com/willin/wrescuetime

License

Apache 2.0