wechat

wechat weixin sdk，支持微信应用和商户。

设计目标

在概念清晰的基础上追求更少的编码、更开放、灵活的结构。

本库不是在微信官方API基础上进一步封装，造出一个新的框架级的重体量SDK。而是努力成为微信官方文档的Golang版快速工具箱。

努力让开发者在学习微信官方文档后，不再有新的学习曲线（另学一套）！

所以本库目标是：极致、简单！不创另行发明新理念、不另行创造新架构！

概述

根据微信的文档，微信的业务有两个不同的领域：

  • 应用类账号下的Api
  • 商户类账号下的Api

安装

go get github.com/blusewang/wechat
应用账号API 
订阅号服务号小程序App
MessageDataQueryQueryaccess_token

时效性凭证安置方式约定

access_tokenjs_sdk_ticketcrontab
crontab

核心设计

算法

MpAccount
UrlSign(url string)ReadMessage(req *http.Request)NewMpReq(path mp_api.MpApi) *mpReq

数据结构

  • 常量：constant.go
  • 基础信息：basic_information.go
  • 自定义菜单：custom_menus.go
  • 消息：message.go
  • 媒体文件上传：media.go
  • 微信网页开发：oa_web_apps.go
  • 用户管理：user.go
  • 账号管理：account.go
  • 对话能力：guide.go
  • 小程序：mini_program.go

只实现了很有限的数据。若需要使用本库自带的数据结构之外的API。完全可以参考本库的数据结构写法，自行另起书写(注意不同业务的tag名称不同)。 并能得到一样的兼容体验！

举例

	a := MpAccount{
		AppId:       "your_app_id",
		AccessToken: "38_XtyPcVUODHd8q3TNYPVGAZ2WNRx_nW4gnclObbv78tsEa1Y_bwdkLALDMEb4372wYqcC_CanjU9O0Zw4MqHiqxrIukk_G4ElAUxyv_ASOb0V2y8647cbxbYU-G8CbtnPdLNub8NrqtUVrSTnWAPaAGALPE",
        // ...
		ServerHost:  mp_api.ServerHostShangHai, // 选择离自己最近的服务主机
	}

    // 一个简单的只带access_token的GET API
	var list mp_api.MessageCustomServiceKfListRes
	if err := a.NewMpReq(mp_api.MessageCustomServiceKfList).Bind(&list).Do(); err != nil {
		t.Error(err)
	}
	log.Println(list)

    // 一个POST API
	var rs mp_api.AccountShortUrlRes
	err = a.NewMpReq(mp_api.AccountShortUrl).SendData(mp_api.AccountShortUrlData{
		Action:  mp_api.ShortUrlAction,
		LongUrl: "https://developers.weixin.qq.com/doc/offiaccount/Account_Management/URL_Shortener.html",
	}).Bind(&rs).Do()
	if err != nil {
		t.Error(err)
	}
	log.Println(rs)

    // 一个上传媒体文件的API
	err = a.NewMpReq(mp_api.MessageCustomServiceKfAccountUploadHeadImg).Query(mp_api.MessageCustomServiceKfAccountUploadHeadImgQuery{
		KfAccount: "1@1",
	}).Upload(resp.Body, "png")
	if err != nil {
		t.Error(err)
	}
商户账号API（V2版） 
App、JSAPI、小程序下单分账付款至微信零钱付款至个人银行卡发红包
MD5HMAC-SHA256

核心设计

算法

MchAccount
NewMchReq(url string)OrderSign4App(or mch_api.PayUnifiedOrderRes)OrderSign(or mch_api.PayUnifiedOrderRes)PayNotify(pn mch_api.PayNotify)RsaEncrypt(plain string)

数据结构

  • 常量：constant.go
  • 数据结构：structs.go

只实现了很有限的数据。若需要使用本库自带的数据结构之外的API。完全可以参考本库的数据结构写法，自行另起书写(建议参考structs.go中的方式书写)。 能得到一样的兼容体验！

举例

    mch := MchAccount{}
    
	var data mch_api.PayProfitSharingRes
	var body = mch_api.PayProfitSharingData{
		TransactionId: "4200000531202004307536721907",
		OutOrderNo:    "TSF_216144_1065_ye7DvHdSed",
	}
	_ = body.SerReceivers([]mch_api.PayProfitSharingReceiver{
		{
			Type:        "",
			Account:     "",
			Amount:      10,
			Description: "",
		},
	})

	err := mch.NewMchReq(mch_api.PayProfitSharing).
		Send(&body). // 注意：发送的数据需传指针，以便自动填充基础信息和签名
		UseHMacSign(). // 指定使用HMAC-SHA256
		UsePrivateCert(). // 指定使用私有证书通信
		Bind(&data).Do() // 传指针
	log.Println(err)
	log.Println(data)
为微信业务数据提供的额外工具方法 
NewRandStrLimitStringSafeString