项目地址

感谢

1.简介

2.使用引导

2.1: 引入

go get -u github.com/l306287405/wechat3rd@master
or
go get -u github.com/l306287405/wechat3rd@v1.7.6 (请选择最新版本)
v1.6.0版本开始Service提供的所有方法仅在resp返回对象中提供错误信息

2.2: 使用NewService方法来创建一个service

NewService的参数分别是:
Config: 配置信息
TicketServer: 保存微信传输的ticket信息接口
AccessTokenServer: 获取第三方平台的token接口
WechatErrorer: 错误信息的处理
// 除Config外的其它参数传nil则使用默认配置. 该处代码你应该使用单例模式或服务池方式来管理
service,err:=wechat3rd.NewService(wechat3rd.Config{
 AppID: os.Getenv("WX_OPEN_APP_ID"), //第三方平台appid
 AppSecret: os.Getenv("WX_OPEN_APP_SECRET"), //第三方平台app_secret
 AESKey: os.Getenv("WX_AES_KEY"), //第三方平台消息加解密Key
 Token: os.Getenv("WX_AES_TOKEN"), //消息校验Token
},nil,nil,nil)
if err!=nil{
 panic("wechat3rd初始化失败:"+err.Error())
}
// 设置第三方平台的ticket 注意该处为示例代码 请替换缓存为自己的缓存服务.
// https://developers.weixin.qq.com/doc/oplatform/Third-party_Platforms/2.0/api/ThirdParty/token/component_verify_ticket.html
// 解释: 当第三方平台应用被创建时,微信每隔10分钟会向用户填写的 授权事件接收URL 发起POST请求,
// 请求中带有12小时有效期的 component_verify_ticket 是服务使用加解密的必备参数.
// 当服务重启时该参数会丢失从而导致服务请求失败,被动的方式是等下一次微信发起授权事件的请求并设置ticket,
// 主动的方式则是将微信发起的ticket缓存起来并在服务启动时获取并设置.
ticket:=cache.Get("cachekey_of_wechat3rd_ticket").Val()
if ticket!=""{
 err=service.SetTicket(ticket)
 if err!=nil{
 common.Log.Error("设置微信isp的ticket失败:",err.Error()," 等待自动获取")
 }
}

2.3: 使用service来接收并验证票据

// 使用你的Golang框架方法获取 *http.Request 这里用iris演示
var r = c.Ctx.Request()
// 该处service应该是从你的单例方法或者服务池中获取
resp,err:=service.ServeHTTP(r)
if err!=nil{
 log.Error("微信第三方开放平台component_verify_ticket获取失败:",err.Error())
 c.Ctx.HTML("error")
 return
}
// 将ticket缓存,并在服务重启时取用.
cache.Set("cachekey_of_wechat3rd_ticket",resp.ComponentVerifyTicket,time.Hour*12)
err=service.SetTicket(resp.ComponentVerifyTicket)
if err!=nil{
 log.Error("微信第三方开放平台component_verify_ticket设置失败:",err.Error())
 c.Ctx.HTML("error")
 return
}
c.Ctx.HTML("success")

2.4: 使用service获取预授权码与授权链接

// 获取预授权码并组装链接
// https://developers.weixin.qq.com/doc/oplatform/Third-party_Platforms/2.0/api/ThirdParty/token/pre_auth_code.html
// 方式一: 直接获取授权链接
authurl,err:=service.AuthUrl(true,"你的授权回调url",wechat3rd.PREAUTH_AUTH_TYPE_MINIAPP,nil)
// 方式二: 你也可以自行获取预授权码并手动拼接授权链接 例如以下代码
resp:=service.PreAuthCode()
if !resp.Success(){
 log.Error("获取授权链接失败:",resp.ErrMsg)
 return
}
r := url.Values{}
// 必选参数
r.Add("component_appid",os.Getenv("WX_OPEN_APP_ID"))
r.Add("pre_auth_code",resp.PreAuthCode)
r.Add("redirect_uri","你的回调url")
r.Add("auth_type",wechat3rd.PREAUTH_AUTH_TYPE_MINIAPP)
// 网页方式授权:授权注册页面扫码授权
authUrl := "https://mp.weixin.qq.com/cgi-bin/componentloginpage?"
authUrl += r.Encode()
println(authUrl)
// 移动设备方式授权:点击移动端链接快速授权
r.Add("action","bindcomponent")
r.Add("no_scan",strconv.Itoa(1))
authUrl := "https://mp.weixin.qq.com/safe/bindcomponent?"
authUrl += r.Encode()+"#wechat_redirect"
println(authUrl)

2.5: 预授权回调处理

// 预授权链接授权操作之后微信会对回调url发起GET请求.
// https://developers.weixin.qq.com/doc/oplatform/Third-party_Platforms/2.0/api/ThirdParty/token/authorization_info.html
// 获取GET auth_code参数 这里用iris做案例
authCode := c.Ctx.URLParam("auth_code")
// 该处service应该是从你的单例方法或者服务池中获取
rsp:=service.QueryAuth(authCode)
if !rsp.Success(){
 return errors.New("换取token失败:"+rsp.ErrMsg)
}
//授权方(也就是小程序持有方,非第三方)令牌信息
info:=rsp.AuthorizationInfo
//info.AuthorizerAppid 授权方的appid
//info.AuthorizerRefreshToken 授权方的刷新token
//info.AuthorizerAccessToken 授权方的authAccessToken
//接下来做你想做的,例如缓存授权方的token,存储授权方的刷新token等
c.Ctx.HTML("授权成功")

3. API实现

openApi管理

第三方平台域名管理

小程序用户隐私保护指引

授权相关接口:

授权方账号管理

开发平台账号管理

代商家注册小程序

创建试用小程序

其他小程序相关接口

小程序模板接口 (全部完成)

6.代小程序实现业务

基础信息设置 (部分完成)

小程序类目管理接口 (全部完成)

成员管理 (全部完成)

代码管理 (全部完成)

订阅消息设置 (全部完成)

支付后获取 Unionid

素材管理

插件管理

工具

todo

* 代小程序实现业务(部分完成)
* 开放平台账号管理
* 代公众号实现业务