状态:beta

官方文档

快速入门

wc := wechat.NewWechat()
memory := cache.NewMemory()
cfg := &openplatform.Config{
    AppID:     "xxx",
    AppSecret: "xxx",
    Token:     "xxx",
    EncodingAESKey: "xxx",
    Cache: memory,
}

//授权的第三方公众号的appID
appID := "xxx"
// 下面文档中提到的openPlatform都是这个变量
openPlatform := wc.GetOpenPlatform(cfg)
officialAccount := openPlatform.GetOfficialAccount(appID)

// 传入request和responseWriter
server := officialAccount.GetServer(req, rw)
//设置接收消息的处理方法
server.SetMessageHandler(func(msg message.MixMessage) *message.Reply {
    if msg.InfoType == message.InfoTypeVerifyTicket {
        componentVerifyTicket, err := openPlatform.SetComponentAccessToken(msg.ComponentVerifyTicket)
        if err != nil {
            log.Println(err)
            return nil
        }
        //debug 
        fmt.Println(componentVerifyTicket)
        rw.Write([]byte("success"))
        return nil
    }
    //handle other message
    //


    return nil
})

//处理消息接收以及回复
err := server.Serve()
if err != nil {
    fmt.Println(err)
    return
}
//发送回复的消息
server.Send()

代第三方公众号 - 发起网页授权

//第三方公众号appid
appid := ""
officialAccount := openPlatform.GetOfficialAccount(appid)
oauth := officialAccount.PlatformOauth()
//重定向到微信oauth授权登录
oauth.Redirect(rw, req, callback, "snsapi_userinfo", "", appid)

代第三方公众号 - 通过网页授权的code 换取access_token

officialAccount := openPlatform.GetOfficialAccount(appid)
componentAccessToken, err := openPlatform.GetComponentAccessToken()
if err != nil {
    fmt.Println(err)
}
accessToken, err := officialAccount.PlatformOauth().GetUserAccessToken(code, appid, componentAccessToken)
if err != nil {
    fmt.Println(err)
}
fmt.Println(accessToken)
// 通过accessToken获取用户信息请参考微信公众号的业务

维护AuthrToken

AuthrToken是平台代第三方公众号调用微信接口的凭据,通过第三方公众号授权给平台时得到的refreshToken来获取

func CheckAuthrToken(appid, refreshToken string) {
    // 获取authrToken
    token, err := openPlatform.GetAuthrAccessToken(appid)
    if err != nil {
        fmt.Println(err)
    }
    if token == "" {
        openPlatform.RefreshAuthrToken(appid, refreshToken)
    }
}

代第三方公众号 - 调用微信接口(以发送微信模板消息为例)

平台代第三方公众号调用微信接口,需要在调用前确保AuthrToken有效,其余操作与公众号一致。

import "github.com/silenceper/wechat/v2/officialaccount/message"

// 在代第三方公众号调用微信接口的时候,需要确保AuthrToken有效
// 这里的appid是第三方公众号的appid
CheckAuthrToken(appid, refreshToken)
msg := &message.TemplateMessage{
    ToUser:     openid,
    TemplateID: templateID,
    URL:        url,
    Data:       data,
}
officialAccount := openPlatform.GetOfficialAccount(appid)
template := message.NewTemplate(officialAccount.GetContext())
msgID, err := template.Send(msg)
if err != nil {
    fmt.Println(err)
}
fmt.Println(msgID)

微信的部分接口(如:获取jsconfig信息)区分了第三方平台调用和公众号直接调用的地址,在文档下方单独进行说明。

代第三方公众号 - 获取jsconfig信息

CheckAuthrToken(appid, refreshToken)
jsConfig, err := openPlatform.GetOfficialAccount(appid).PlatformJs().GetConfig(uri, appid)
if err != nil {
    fmt.Println(err)
}
fmt.Println(jsConfig)

全网发布校验

微信第三方平台进行全网发布的时候,会有一个全网发布接入检测的过程。
官方文档

wc := wechat.NewWechat()
memory := cache.NewMemory()
cfg := &openplatform.Config{
    AppID:     "xxx",
    AppSecret: "xxx",
    Token:     "xxx",
    EncodingAESKey: "xxx",
    Cache: memory,
}

//授权的第三方公众号的appID
appID := "xxx"
// 下面文档中提到的openPlatform都是这个变量
openPlatform := wc.GetOpenPlatform(cfg)
officialAccount := openPlatform.GetOfficialAccount(appID)

// 传入request和responseWriter
server := officialAccount.GetServer(req, rw)
//设置接收消息的处理方法
server.SetMessageHandler(func(msg message.MixMessage) *message.Reply {
    switch msg.InfoType {
    case message.InfoTypeVerifyTicket:
        // 在这里处理推送的VerifyTicket
        // 测试验证票据推送流程
        rw.Write([]byte("success"))
    case message.InfoTypeAuthorized:
        // 微信会推送测试号的query_auth_code过来,需要在这里获取到测试号的AuthrToken
        // 参照开放平台的`维护AuthrToken`小节
    }
    switch msg.MsgType {
    case message.MsgTypeText:
        if msg.Content == "TESTCOMPONENT_MSG_TYPE_TEXT" {
            // 测试公众号处理用户消息
            return &message.Reply{
                MsgType: message.MsgTypeText,
                MsgData: message.NewText("TESTCOMPONENT_MSG_TYPE_TEXT_callback"),
            }
        }
        // 测试公众号使用客服消息接口处理用户消息
        if strings.HasPrefix(msg.Content, "QUERY_AUTH_CODE") {
            // 立即回复空串
            rw.Write([]byte(""))
            var data = strings.Split(msg.Content, ":")
            if len(data) == 2 {
                // 调用客服接口回复消息
                customerMsg := message.NewCustomerTextMessage(string(msg.FromUserName), fmt.Sprintf("%s_from_api", data[1]))
                CheckAuthrToken(appid, refreshToken)
                officialAccount := openPlatform.GetOfficialAccount(appid)
                msgManager := message.NewMessageManager(officialAccount.GetContext())
                msgManager.Send(msg)
            }
        }
    }    
    return nil
})

//处理消息接收以及回复
err := server.Serve()
if err != nil {
    fmt.Println(err)
    return
}
//发送回复的消息
server.Send()

公众号授权流程

小程序或者公众号授权给第三方平台的流程
官方文档

扫码授权

// 获取公众号扫码授权页面链接
loginPageURL, err := openPlatform.GetComponentLoginPage(redirectURI, authType, "")
// ...引导用户扫码授权
// 注意: 这里微信会校验跳转到授权页的referer,必须与第三方平台后台设置的`登录授权的发起页域名`一致
// ---------
// 通过授权回调获取到的authCode换取公众号或小程序的接口调用凭据和授权信息
authInfo, err := openPlatform.QueryAuthCode(authCode)
// ...处理公众号授权后的逻辑, 存储refreshToken
文档更新时间: 2020-08-19 10:35   作者:kuteng