Skip to content

Latest commit

 

History

History
366 lines (251 loc) · 7.52 KB

Readme.md

File metadata and controls

366 lines (251 loc) · 7.52 KB

微信小程序 SDK （for Golang）

拉取代码

go get -u github.com/medivhzhan/weapp

获取 access_token 及其有效期

import "github.com/medivhzhan/weapp/token"

// 获取次数有限制 获取后请缓存
tok, exp, err := token.AccessToken(appID, secret string)

用户登录

import "github.com/medivhzhan/weapp"

// 需要从小程序客户端获取到的code
oid, ssk, err := weapp.Login(appID, secret, code string)

二维码

获取小程序码: 适用于需要的码数量较少的业务场景

import "github.com/medivhzhan/weapp/code"

coder := code.QRCoder {
    Path: "pages/index?query=1", // 识别二维码后进入小程序的页面链接
    With: 430, // 图片宽度
    IsHyaline: true, // 是否需要透明底色
    AutoColor: true, // 自动配置线条颜色，如果颜色依然是黑色，则说明不建议配置主色调
    LineColor: code.Color{ //  AutoColor 为 false 时生效，使用 rgb 设置颜色 十进制表示
        R: "50",
        G: "50",
        A: "50",
    },
}

// 获取小程序码
// token: 微信access_token
res, err := coder.AppCode(token string)
if err != nil {
    // handle error
}
defer res.Body.Close()

获取小程序码: 适用于需要的码数量极多的业务场景

import "github.com/medivhzhan/weapp/code"

coder := code.QRCoder {
    Scene: "...", // 参数数据
    Page: "pages/index", // 识别二维码后进入小程序的页面链接
    With: 430, // 图片宽度
    IsHyaline: true, // 是否需要透明底色
    AutoColor: true, // 自动配置线条颜色，如果颜色依然是黑色，则说明不建议配置主色调
    LineColor: code.Color{ //  AutoColor 为 false 时生效，使用 rgb 设置颜色 十进制表示
        R: "50",
        G: "50",
        A: "50",
    },
}

// 获取小程序码
// token: 微信access_token
res, err := coder.UnlimitedAppCode(token string)
if err != nil {
    // handle error
}
defer res.Body.Close()

获取小程序二维码: 适用于需要的码数量较少的业务场景

import "github.com/medivhzhan/weapp/code"

coder := code.QRCoder {
    Path: "pages/index?query=1", // 识别二维码后进入小程序的页面链接
    With: 430, // 图片宽度
}

// 获取小程序二维码
// token: 微信access_token
res, err := coder.QRCode(token string)
if err != nil {
    // handle error
}
defer res.Body.Close()

模板消息

获取小程序模板库标题列表

import "github.com/medivhzhan/weapp/message/template"

// 获取小程序模板库标题列表
// offset: 开始获取位置 从0开始
// count: 获取记录条数 最大为20
// token: 微信 access_token
list, total, err := template.List(offset uint, count uint, token string)

获取帐号下已存在的模板列表

import "github.com/medivhzhan/weapp/message/template"

// 获取帐号下已存在的模板列表
// offset: 开始获取位置 从0开始
// count: 获取记录条数 最大为20
// token: 微信 access_token
list, total, err := template.Selves(offset uint, count uint, token string)

获取模板库某个模板标题下关键词库

import "github.com/medivhzhan/weapp/message/template"

// 获取模板库某个模板标题下关键词库
// id: 模板ID
// token: 微信 access_token
keywords, err := template.Get(id, token string)

组合模板并添加至帐号下的个人模板库

import "github.com/medivhzhan/weapp/message/template"

// 组合模板并添加至帐号下的个人模板库
// id: 模板ID
// token: 微信 aceess_token
// keywordIDList: 关键词 ID 列表
// 返回新建模板ID和错误信息
tid, err := template.Add(id, token string, keywordIDList []uint)

删除帐号下的某个模板

import "github.com/medivhzhan/weapp/message/template"

// 删除帐号下的某个模板
// id: 模板ID
// token: 微信 aceess_token
err := template.Delete(id, token string)

发送模板消息

import "github.com/medivhzhan/weapp/message/template"

// 发送模板消息
// openid: 接收者（用户）的 openid
// template: 所需下发的模板消息的id
// page: 点击模板卡片后的跳转页面，仅限本小程序内的页面。支持带参数,（示例index?foo=bar）。该字段不填则模板无跳转。
// formID: 表单提交场景下，为 submit 事件带上的 formId；支付场景下，为本次支付的 prepay_id
// data: 模板内容，不填则下发空模板
// color: 模板内容字体的颜色，不填默认黑色
// emphasisKeyword: 模板需要放大的关键词，不填则默认无放大
err := template.Send(openid, template, page, formID, data, color, emphasisKeyword, token string)

客服消息

回复

import "github.com/medivhzhan/weapp/message"

// 文本消息
msg := message.Text{
    Content: "消息内容",
}

// 图片消息
msg := message.Image{
    MediaID: "微信media_id"
}

// 图文链接消息
msg := message.Link{
    Title: "标题"
    Description: "描述"
    URL: "点击跳转链接"
    ThumbURL: "图片链接"
}

// 卡片消息
msg := message.Card{
    Title: "标题"
    PagePath: "小程序页面路径"
    ThumbMediaID: "卡封面图片 media_id"
}

// 发送消息
// openid: 用户 openid
// token: 微信 access_token
res, err := msg.SendTo(openid, token string)

处理微信通知

支付

测试中 ...

import "github.com/medivhzhan/weapp/notify"

// 处理支付结果通知
err := notify.HandlePaidNotify(w http.ResponseWriter, req *http.Request, func(ntf notify.PaidNotify) {
    // 处理通知

    // 处理成功 return true, ""
    // or
    // 处理失败 return false, "失败原因..."
})

// 处理退款结果通知
// key: 微信支付 KEY
err := notify.HandleRefundedNotify(w http.ResponseWriter, req *http.Request, key string, func(ntf notify.RefundedNotify) {

    // 处理通知

    // 处理成功 return true, ""
    // or
    // 处理失败 return false, "失败原因..."
})

消息

import "github.com/medivhzhan/weapp/notify"

// 新建服务
srv := notify.NewServer(http.ResponseWriter, *http.Request)

srv.HandleTextMessage(func(msg notify.Text)) {
    // 处理文本消息
})

srv.HandleCardMessage(func(msg notify.Card)) {
    // 处理卡片消息
})

srv.HandleImageMessage(func(msg notify.Image)) {
    // 处理图片消息
})

srv.HandleEvent(func(msg notify.Event)) {
    // 处理事件
})

// 执行服务
err := srv.Serve()

其他

解密手机号码

import "github.com/medivhzhan/weapp"

// 解密手机号码
//
// @ssk 通过 Login 向微信服务端请求得到的 session_key
// @data 小程序通过 api 得到的加密数据(encryptedData)
// @iv 小程序通过 api 得到的初始向量(iv)
phone , err := weapp.DecryptPhoneNumber(ssk, data, iv string)

// 访问内容
// phone.PhoneNumber
// phone.PurePhoneNumber
// phone.CountryCode
// ...

解密用户信息

import "github.com/medivhzhan/weapp"

// 解密用户信息
//
// @rawData 不包括敏感信息的原始数据字符串，用于计算签名。
// @encryptedData 包括敏感数据在内的完整用户信息的加密数据
// @signature 使用 sha1( rawData + session_key ) 得到字符串，用于校验用户信息
// @iv 加密算法的初始向量
// @ssk 微信 session_key
ui, err := weapp.DecryptUserInfo(rawData, encryptedData, signature, iv, ssk string)

// 访问内容
// ui.OpenID
// ui.Nickname
// ui.Gender
// ...

未实现功能

  1. 接收加密消息
  2. 微信支付
  3. 数据统计
  4. 临时素材