goweixin

微信服务端API接口Golang SDK

如何使用

go get -u -v github.com/hunterhug/goweixin

一. 小程序开发

A. 小程序登录

小程序登录区别于网页登录，需要客户端和服务端联调，获取密钥对请登陆 微信公众平台。

逻辑如下：

1. 客户端先调用 wx.login() 获取临时登录凭证 code 并且 获取用户信息 获取 encryptedData 和 iv 并回传到开发者服务器。
2. 服务端使用该 code 调用 auth.code2Session 获取解密密钥，然后解密用户信息。

你只需使用该 SDK 实现登录并获取用户信息即可：

func TestMiniProgramClient_LoginGetUserInfo(t *testing.T) {
	appId := "wxd4e08529844845e7"
	appSecret := "e6782244f7a7e994d20721f004e3e9ae"

	c := NewMiniProgramClient(appId, appSecret)

	code := "013TX31w326TEZ2I2f4w3Hol9j2TX31N"
	encryptedData := "98A19r2TH/F+biCYbx6YE9dnMjWVZfUgqPEWFenYX3jP8JpIKihNCyjE/Or0/pmYT+PCn6wCmV7s5LDwwQ92kcrMpuInOrmPWD36pI0mfywqh+53BcN4G+d30aG6ehCV3hPEqxE35ImpXxE5xuWqqsLX0YvgCgA5hLBGRWRPGiiXN4eSrLvCNI58BlC8VG16Iz6Z89NqAQ5WsQrWPjJqygZOsGnkvTFTwKzs6eM4jlmceWv4B37NxecCAwRkkHZRxla5mdluL5lwKovfH5feDQTg2Ui2/4Mc/raIh9tXV6lUqEkn8f4yJFhjXwJuhXdITxLcKnqP6O/n1DUOn1xNh5imZEiDBil14Zvy71pvb5JdRPhurtqOFM/5wCRc7BXwrrDo1iMUw3e7OOL9gFu7Fg=="
	iv := "+DTYOLIe/s1ObkVKZQolpw=="

	userInfo, err := c.LoginGetUserInfo(code, encryptedData, iv)
	if err != nil {
		fmt.Println(err.Error())
		return
	}

	fmt.Printf("%#v", userInfo)
}

特殊说明，2.27.0 以后的小程序版本 无法使用该接口。详情见：小程序用户头像昵称获取规则调整公告 。

最新方案：

服务端请直接获取用户的基本信息 OpenId，UnionId，改用：

func TestMiniProgramClient_LoginGetBaseInfo(t *testing.T) {
	appId := "wxd4e08529844845e7"
	appSecret := "e6782244f7a7e994d20721f004e3e9ae"

	c := NewMiniProgramClient(appId, appSecret)

	code := "033SD2100a5hZO15kd100qqPJf2SD21f"
	result, err := c.LoginGetBaseInfo(code)
	if err != nil {
		fmt.Println(err.Error())
		return
	}

	fmt.Printf("%s,%s", result.OpenId, result.UnionId)
}

客户端使用开放能力：头像昵称填写 ，然后将头像和昵称直接发给服务端，服务端自行进行用户绑定。

B. 小程序发送 消息订阅

发送完全在服务端执行，不需要客户端参与。但是客户端需要调用 wx.requestSubscribeMessage 订阅弹窗，引导用户订阅，

逻辑如下：

1. 客户端调起小程序订阅消息界面，返回用户订阅消息的操作结果 。当用户勾选了订阅面板中的“总是保持以上选择，不再询问”时，模板消息会被添加到用户的小程序设置页。
2. 服务端先获取全局 access_token 。
3. 服务端直接发送订阅消息 。

func TestMiniProgramClient_SendMessage(t *testing.T) {
	appId := "wxd4e08529844845e7"
	appSecret := "e6782244f7a7e994d20721f004e3e9ae"

	c := NewMiniProgramClient(appId, appSecret)

	token, err := c.AuthGetAccessToken()
	if err != nil {
		fmt.Println(err.Error())
		return
	}

	fmt.Println("token is:", token)

	openId := "on9VO5YXH_gMLxRKMql98IUjtzkI"
	templateId := "IgOxNz7ydQn9UsssswIwiggdd5TroAbRLXcosY"
	page := "index?foo=bar"
	data := map[string]string{"thing1": "这是一个内容", "thing7": "这个也是内容", "thing3": "这个也是内容啊"}

	err = c.SendMessage(token, openId, templateId, page, data)
	if err != nil {
		fmt.Println("send err:", err.Error())
		return
	}
}

C. 获取手机号

需要客户端和服务端联调。

逻辑如下：

1. 客户端调用 <button open-type="getPhoneNumber" bindgetphonenumber="getPhoneNumber"></button> 获取到 code 传给服务端。
2. 服务端先获取全局 access_token 。
3. 服务端再配合 code 调用 phonenumber.getPhoneNumber 获取手机号。

func TestMiniProgramClient_GetPhoneNumber(t *testing.T) {
	appId := "wxd4e08529844845e7"
	appSecret := "e6782244f7a7e994d20721f004e3e9ae"

	c := NewMiniProgramClient(appId, appSecret)

	token, err := c.AuthGetAccessToken()
	if err != nil {
		fmt.Println(err.Error())
		return
	}

	fmt.Println("token is:", token)

	code := "910031e46a34e633401c2ebb23f281646ea9775ad8c1276b793e59846f0ddb22"
	phone, err := c.GetPhoneNumber(token, code)
	if err != nil {
		fmt.Println(err.Error())
		return
	}

	fmt.Printf("%#v", phone)
}

D. 地理位置获取

仅客户端操作。详见：地理位置接口新增与相关流程调整 。

其他：获取用户收货地址 。

二. 公众号开发

A. 公众号：微信 JS-SDK 权限验证配置- jsapi_ticket 获取

PS：请勿使用小程序的 app_id 密钥对，而是应该用公众号的密钥对。运用在微信内打开 h5 页面。

完全在服务端操作，客户端只需传入 url，使用方式：

func TestGzClient_GetJsapiTicketAndSign(t *testing.T) {
	appId := "wxd4e08529844845e7"
	appSecret := "e6782244f7a7e994d20721f004e3e9ae"

	c := NewGzClient(appId, appSecret)

	result, sign, err := c.GetJsapiTicketAndSign("http://mp.weixin.qq.com?params=value")
	if err != nil {
		fmt.Println(err.Error())
		return
	}

	fmt.Printf("%#v, %#v", result, sign)
}

返回的配置如下，签名算法参考：官方：

{
    appId:"wxd4e08529844845e7", 
    nonceStr:"1671072500641800000", 
    timestamp:1671072500, 
    signature:"a03eb72c2a39ef4151f510d5895e8d4786d27c8f"
}

三. 网站应用开发

A. 微信第三方登录

适用于网页端，移动端APP的微信登录。具体参考官方文档 。

需要客户端和服务端联调。

逻辑如下：

1.客户端先调用以下接口（网站内嵌二维码微信登录JS实现请见官方文档）:

https://open.weixin.qq.com/connect/qrconnect?appid=wxbdc5610cc59c1631&redirect_uri=http://127.0.0.1:9999&response_type=code&scope=snsapi_login,snsapi_userinfo&state=test#wechat_redirect

微信用户允许授权第三方应用后，微信将会携带 CODE 并且回调到 redirect_uri，类似： http://127.0.0.1:9999?code=CODE&state=STATE，其中 STATE 一般为我们自己网站内部的用户标志。

当提示 redirect_uri 参数错误 请去开放平台配置授权回调域。

2.将第一步得到的 CODE 提交给服务端，服务端调用以下链接:

https://api.weixin.qq.com/sns/oauth2/access_token?appid=wxbdc5610cc59c1631&secret=00cc512fc031fcdsfsdfba01c8a41f05b4b5&code=CODE&grant_type=authorization_code

将获取到 access_token，unionid，openid，继续调用以下链接获取用户信息：

https://api.weixin.qq.com/sns/userinfo?access_token=accessToken&openid=openid&lang=zh_CN

你只需使用该 SDK 实现登录即可：

func TestOpenClient_LoginGetUserInfo(t *testing.T) {
	miner.SetLogLevel(miner.INFO)

	appId := "wxbdc5610cc59c1631"
	appSecret := "e6782244f7a7e994d20721f004e3e9ae"

	fmt.Println(appId, appSecret)

	c := NewOpenClient(appId, appSecret)

	code := "033SD2100a5hZO15kd100qqPJf2SD21f"
	result, err := c.LoginGetUserInfo(code)
	if err != nil {
		fmt.Println(err.Error())
		return
	}

	fmt.Printf("%s,%s", result.OpenId, result.UnionId)
}