这是一个使用Go语言对微信公众平台的封装。参考了微信公众平台API文档
通过执行下列语句就可以完成安装
go get github.com/wizjin/weixin
注册微信公众平台，填写验证微信公众平台的Token
package main
import (
"github.com/wizjin/weixin"
"net/http"
)
// 文本消息的处理函数
func Echo(w weixin.ResponseWriter, r *weixin.Request) {
txt := r.Content // 获取用户发送的消息
w.ReplyText(txt) // 回复一条文本消息
w.PostText("Post:" + txt) // 发送一条文本消息
}
// 关注事件的处理函数
func Subscribe(w weixin.ResponseWriter, r *weixin.Request) {
w.ReplyText("欢迎关注") // 有新人关注，返回欢迎消息
}
func main() {
// my-token 验证微信公众平台的Token
// app-id, app-secret用于高级API调用。
// 如果仅使用接收/回复消息，则可以不填写，使用下面语句
// mux := weixin.New("my-token", "", "")
mux := weixin.New("my-token", "app-id", "app-secret")
// 注册文本消息的处理函数
mux.HandleFunc(weixin.MsgTypeText, Echo)
// 注册关注事件的处理函数
mux.HandleFunc(weixin.MsgTypeEventSubscribe, Subscribe)
http.Handle("/", mux) // 注册接收微信服务器数据的接口URI
http.ListenAndServe(":80", nil) // 启动接收微信数据服务器
}微信公众平台要求在收到消息后5秒内回复消息（Reply接口） 如果时间操作很长，则可以使用Post接口发送消息
处理函数的定义可以使用下面的形式
func Func(w weixin.ResponseWriter, r *weixin.Request) {
...
}可以注册的处理函数类型有以下几种
weixin.MsgTypeText接收文本消息weixin.MsgTypeImage接收图片消息weixin.MsgTypeVoice接收语音消息weixin.MsgTypeVideo接收视频消息weixin.MsgTypeLocation接收地理位置消息weixin.MsgTypeLink接收链接消息weixin.MsgTypeEventSubscribe接收关注事件weixin.MsgTypeEventUnsubscribe接收取消关注事件weixin.MsgTypeEventScan接收扫描二维码事件weixin.MsgTypeEventClick接收自定义菜单事件
需要发送被动响应消息，可通过weixin.ResponseWriter的下列方法完成
ReplyText(text)回复文本消息ReplyImage(mediaId)回复图片消息ReplyVoice(mediaId)回复语音消息ReplyVideo(mediaId, title, description)回复视频消息ReplyMusic(music)回复音乐消息ReplyNews(articles)回复图文消息
PostText(text)发送文本消息PostImage(mediaId)发送图片消息PostVoice(mediaId)发送语音消息PostVideo(mediaId, title, description)发送视频消息PostMusic(music)发送音乐消息PostNews(articles)发送图文消息
使用如下函数可以用来下载多媒体文件:
DownloadMedia(mediaId string, writer io.Writer)
示例 (收到一条图片消息，然后保存图片到本地文件):
func ReciveImageMessage(w weixin.ResponseWriter, r *weixin.Request) {
file, err := os.Create("/my-file-path") // 创建本地文件文件
if err != nil {
w.ReplyText("保存图片失败")
} else {
w.DownloadMedia(r.MediaId, file) // 下载文件并保存到本地
w.ReplyText("保存图片成功")
}
}This project is licensed under the MIT license, see LICENSE.
- 多媒体文件处理：上传/下载多媒体文件
- 发送客服消息：文本消息，图片消息，语音消息，视频消息，音乐消息，图文消息
- Token验证URL有效性
- 接收普通消息：文本消息，图片消息，语音消息，视频消息，地理位置消息，链接消息
- 接收事件推送：关注/取消关注，扫描二维码事件，上报地理位置，自定义菜单
- 发送被动响应消息：文本消息，图片消息，语音消息，视频消息，音乐消息，图文消息