gochat

微信 Go SDK

获取

go get -u github.com/shenghui0779/gochat 

使用须知

• 微信 API 被封装成 Action 接口（授权 和 AccessToken 等部分 API 除外）
• 每个 API 对应一个 Action，统一由 Do 方法执行
• 除支付（ mch ）外，返回结果均以 Result 为前缀的结构体指针接收
• 对于微信支付的回调通知处理，提供了两个方法：
  • 验签 - VerifyWXMLResult
  • 解密 - DecryptWithAES256ECB (退款)
• 对于微信推送的事件消息处理，提供了三个方法：
  • 验签 - VerifyEventSign
  • 解密 - DecryptEventMessage
  • 回复 - Reply
• 企业微信按照不同功能模块划分了相应的目录，根据 URL 可以找到对应的目录和文件
• 所有 API 均采用 Mock 单元测试（ Mock 数据来源于官方文档，如遇问题，欢迎提Issue）

支付

• 版本：V2
• 模式：普通商户直连模式

import ( "github.com/shenghui0779/gochat" "github.com/shenghui0779/gochat/wx" "github.com/shenghui0779/gochat/mch" ) // 创建实例 pay := gochat.NewMch("mchid", "apikey", tls.Certificate...) // 设置 debug 模式（支持自定义日志） pay.SetClient(wx.WithDedug(), wx.WithLogger(wx.Logger)) // --------- 统一下单 ------------------------------- action := mch.UnifyOrder("appid", &mch.ParamsUnifyOrder{...}) result, err := pay.Do(ctx, action) if err != nil { log.Println(err) return } fmt.Println(result) // --------- 拉起支付 ------------------------------- // APP 支付 pay.APPAPI("appid", "prepayID") // JSAPI/小程序支付 pay.JSAPI("appid", "prepayID") // 小程序红包 pay.MinipRedpackJSAPI("appid", "package") 

公众号

import ( "github.com/shenghui0779/gochat" "github.com/shenghui0779/gochat/wx" "github.com/shenghui0779/gochat/offia" ) // 创建实例 oa := gochat.NewOffia("appid", "appsecret") // 设置服务器配置 oa.SetServerConfig("token", "encodingAESKey") // 设置 debug 模式（支持自定义日志） oa.SetClient(wx.WithDedug(), wx.WithLogger(wx.Logger)) // --------- 生成网页授权 URL ------------------------------- url := oa.OAuth2URL(offia.ScopeSnsapiBase, "redirectURL", "state") fmt.Println(url) // --------- 获取网页授权 Token ------------------------------- result, err := oa.Code2OAuthToken(ctx, "code") if err != nil { log.Println(err) return } fmt.Println(result) // --------- 获取 AccessToken ------------------------------- result, err := oa.AccessToken(ctx) if err != nil { log.Println(err) return } fmt.Println(result) // --------- 获取关注的用户列表 ------------------------------- result := new(offia.ResultUserList) action := offia.GetUserList("nextOpenID", result) if err := oa.Do(ctx, action); err != nil { log.Println(err) return } fmt.Println(result) 

小程序

import ( "github.com/shenghui0779/gochat" "github.com/shenghui0779/gochat/wx" "github.com/shenghui0779/gochat/minip" ) // 创建实例 oa := gochat.NewMinip("appid", "appsecret") // 设置服务器配置 oa.SetServerConfig("token", "encodingAESKey") // 设置 debug 模式（支持自定义日志） oa.SetClient(wx.WithDedug(), wx.WithLogger(wx.Logger)) // --------- 获取授权 SessionKey ------------------------------- result, err := oa.Code2Session(ctx, "code") if err != nil { log.Println(err) return } fmt.Println(result) // --------- 获取 AccessToken ------------------------------- result, err := oa.AccessToken(ctx) if err != nil { log.Println(err) return } fmt.Println(result) // --------- 解密授权的用户信息 ------------------------------- result := new(minip.UserInfo) if err := DecryptAuthInfo("sessionKey", "iv", "encryptedData", result); err != nil { log.Println(err) return } fmt.Println(result) // --------- 创建小程序二维码 ------------------------------- qrcode := new(minip.QRCode) action := minip.CreateQRCode("pagepath", 120, qrcode) if err := minip.Do(ctx, action); err != nil { log.Println(err) return } fmt.Println(base64.StdEncoding.EncodeToString(qrcode.Buffer)) 

企业微信

import ( "github.com/shenghui0779/gochat" "github.com/shenghui0779/gochat/wx" "github.com/shenghui0779/gochat/corp" "github.com/shenghui0779/gochat/corp/addrbook" ) // 创建实例 cp := gochat.NewCorp("corpid") // 设置服务器配置 cp.SetServerConfig("token", "encodingAESKey") // 设置 debug 模式（支持自定义日志） cp.SetClient(wx.WithDedug(), wx.WithLogger(wx.Logger)) // --------- 生成网页授权 URL ------------------------------- url := cp.OAuth2URL(corp.ScopeSnsapiBase, "redirectURL", "state") fmt.Println(url) // --------- 生成扫码授权 URL ------------------------------- url := cp.QRCodeAuthURL("agentID", "redirectURL", "state") fmt.Println(url) // --------- 获取 AccessToken ------------------------------- result, err := cp.AccessToken(ctx, "secret") if err != nil { log.Println(err) return } fmt.Println(result) // --------- 获取部门列表 ------------------------------- result := new(addrbook.ResultDepartmentList) action := addrbook.ListDepartment(0, result) if err := cp.Do(ctx, action); err != nil { log.Println(err) return } fmt.Println(result) 

说明

• API Reference
• 注意：因 access_token 每日获取次数有限且含有效期，故服务端应妥善保存 access_token 并定时刷新
• 配合 yiigo 使用，可以更方便的操作 MySQL、MongoDB 与 Redis 等

Enjoy