Golang實(shí)現(xiàn)微信公眾號(hào)后臺(tái)接入的示例代碼
最近在學(xué)習(xí)Golang,寫了個(gè)微信公眾號(hào)項(xiàng)目練練手。
一、開發(fā)前準(zhǔn)備
1、注冊(cè)微信公眾號(hào)
百度搜索微信公眾號(hào)進(jìn)入官網(wǎng),注冊(cè)一個(gè)訂閱號(hào),其他信息按要求填寫即可。
注冊(cè)完成后進(jìn)入個(gè)人公眾號(hào)主頁,下拉至設(shè)置與開發(fā)
點(diǎn)擊基本配置,查看AppID和AppSecret(之后進(jìn)行代碼開發(fā)會(huì)用到)。
2、服務(wù)器配置
然后進(jìn)行服務(wù)器配置,由于是本地開發(fā),為了方便調(diào)試,可以暫時(shí)使用內(nèi)網(wǎng)穿透工具ngork映射公網(wǎng)地址,具體的使用方法網(wǎng)上都有,在此就不多贅述。
下載完成后是一個(gè)可執(zhí)行文件
在當(dāng)前目錄打開命令行窗口輸入命令啟動(dòng)ngork
ngork.exe http 80
將本地80端口映射到公網(wǎng)地址
將映射的公網(wǎng)地址填入服務(wù)器URL,令牌Token填寫一個(gè)自定義的字符串(之后進(jìn)行代碼編寫時(shí)會(huì)用到),然后使用明文模式。
至此基本配置完成,接下來就是代碼開發(fā)。
二、代碼編寫
使用Golang的http包創(chuàng)建一個(gè)web服務(wù)器
package main import ( "fmt" "net/http" "wechat-oa/route" ) func main() { fmt.Println("====== 微信公眾號(hào)服務(wù)器程序 ======") http.HandleFunc("/", route.WechatServer) // 處理微信服務(wù)器請(qǐng)求 err := http.ListenAndServe(":80", nil) if err != nil { fmt.Println("wechat server start error", err) } }
微信服務(wù)器發(fā)送請(qǐng)求都會(huì)帶上4個(gè)參數(shù),以此判斷請(qǐng)求是否來自微信服務(wù)器。
開發(fā)者通過檢驗(yàn) signature 對(duì)請(qǐng)求進(jìn)行校驗(yàn)(下面有校驗(yàn)方式)。若確認(rèn)此次 GET 請(qǐng)求來自微信服務(wù)器,請(qǐng)?jiān)瓨臃祷?echostr 參數(shù)內(nèi)容,則接入生效,成為開發(fā)者成功,否則接入失敗。加密/校驗(yàn)流程如下:
1)將token、timestamp、nonce三個(gè)參數(shù)進(jìn)行字典序排序
2)將三個(gè)參數(shù)字符串拼接成一個(gè)字符串進(jìn)行sha1加密
3)開發(fā)者獲得加密后的字符串可與 signature 對(duì)比,標(biāo)識(shí)該請(qǐng)求來源于微信
公眾號(hào)配置
// 微信公眾號(hào)平臺(tái)配置 const ( appId = "xxxxxxxxxx" // 公眾號(hào)開發(fā)識(shí)別碼 appSecret = "xxxxxxxxxx" // 公眾號(hào)開發(fā)者密碼 encodingAESKey = "xxxxxxxxxx" // 消息加密秘鑰 token = "xxxxxxxxxx" // 跟微信公眾平臺(tái)的token一樣即可 )
服務(wù)處理代碼
當(dāng)在服務(wù)器配置頁面點(diǎn)擊啟用時(shí)微信服務(wù)器會(huì)向配置服務(wù)器發(fā)送GET請(qǐng)求已驗(yàn)證服務(wù)器是否可用
func WechatServer(w http.ResponseWriter, req *http.Request) { defer req.Body.Close() fmt.Println("服務(wù)器請(qǐng)求: ", req) //打印http的請(qǐng)求url // 1、驗(yàn)證消息是否來自微信服務(wù)器 hashcode,signature,echostr := handleValid(req) if hashcode != signature { // 校驗(yàn) return } // 2、請(qǐng)求處理 if req.Method == "GET" { _, _ = w.Write([]byte(echostr)) // 驗(yàn)證成功返回echostr } else if req.Method == "POST" { handleMsg(w,req) }else { _, _ = w.Write([]byte("error")) } }
驗(yàn)證代碼
以下代碼通過加密規(guī)則對(duì)請(qǐng)求參數(shù)進(jìn)行加密,最后返回加密后的hashcode
func handleValid(r *http.Request) (hashcode string,signature string,echostr string){ //1.嘗試獲取4個(gè)字段 nonce := r.URL.Query().Get("nonce") timestamp := r.URL.Query().Get("timestamp") signature = r.URL.Query().Get("signature") echostr = r.URL.Query().Get("echostr") //2. 賦值一個(gè)token //3.token,timestamp,nonce按字典排序的字符串list strs := sort.StringSlice{token, timestamp, nonce} // 使用本地的token生成校驗(yàn) sort.Strings(strs) str := "" for _, s := range strs { str += s } // 4. 哈希算法加密list得到hashcode h := sha1.New() h.Write([]byte(str)) hashcode = fmt.Sprintf("%x", h.Sum(nil)) // h.Sum(nil) 做hash return }
消息處理
// 處理POST請(qǐng)求 // 微信服務(wù)器會(huì)將用戶發(fā)送的數(shù)據(jù)以POST請(qǐng)求的方式轉(zhuǎn)發(fā)給開發(fā)者服務(wù)器 func handleMsg(rw http.ResponseWriter, req *http.Request) { wc := wechat.NewWechat() //這里本地內(nèi)存保存access_token,也可選擇redis,memcache或者自定義cache memory := cache.NewMemory() cfg := &offConfig.Config{ AppID: appId, AppSecret: appSecret, Token: token, EncodingAESKey: encodingAESKey, Cache: memory, } // 底層根據(jù)AppID和AppSecret獲取access_token并保存到cache中 // access_token每?jī)蓚€(gè)小時(shí)刷新一次 officialAccount := wc.GetOfficialAccount(cfg) // 傳入request和responseWriter server := officialAccount.GetServer(req, rw) // 設(shè)置接收消息的處理方法 server.SetMessageHandler(controller.HandleMsg) //處理消息接收以及回復(fù) err := server.Serve() if err != nil { fmt.Println(err) return } //發(fā)送回復(fù)的消息 _ = server.Send() }
controller.HandleMsg
這里的基本邏輯是根據(jù)用戶發(fā)送消息的類型作不同的處理,目前只處理了文本消息和事件推送消息。
當(dāng)用戶發(fā)送文本消息時(shí)回復(fù)用戶自己發(fā)送的消息
// 處理用戶發(fā)送的消息 func HandleMsg(msg *message.MixMessage) *message.Reply{ fmt.Println("接收用戶消息:",msg.Content) switch msg.MsgType { case message.MsgTypeText: // 文本消息 return &message.Reply{ MsgType: message.MsgTypeText, MsgData: message.NewText(msg.Content), } case message.MsgTypeEvent: // 事件推送 return service.HandleEventMsg(msg) default: return &message.Reply{ MsgType: message.MsgTypeText, MsgData: message.NewText("感謝關(guān)注沐風(fēng)丶,更多功能正在開發(fā)中..."), } } }
service.HandleEventMsg
// 處理事件推送 func HandleEventMsg(msg *message.MixMessage) *message.Reply{ switch msg.Event { case message.EventSubscribe: // 用戶訂閱 fmt.Printf("%s 訂閱了你 \n",msg.FromUserName) return &message.Reply{ MsgType: message.MsgTypeText, MsgData: message.NewText("感謝關(guān)注沐風(fēng)丶,(* ̄︶ ̄)?你真好看"), } case message.EventUnsubscribe: // 用戶取消訂閱 fmt.Printf("%s 取消了訂閱 \n",msg.FromUserName) return &message.Reply{ MsgType: message.MsgTypeText, MsgData: message.NewText(""), } default: return &message.Reply{ MsgType: message.MsgTypeText, MsgData: message.NewText("default"), } } }
三、測(cè)試
1、啟動(dòng)項(xiàng)目
2、啟動(dòng)服務(wù)器配置
啟動(dòng)成功后服務(wù)器響應(yīng)
3、用戶關(guān)注公眾號(hào)
服務(wù)器響應(yīng)
4、用戶發(fā)送消息
服務(wù)器響應(yīng)
5、用戶取消訂閱
服務(wù)器響應(yīng)
四、總結(jié)
更多文檔:開發(fā)文檔
個(gè)人訂閱號(hào)無法進(jìn)行微信認(rèn)證,許多接口都沒有權(quán)限,推薦使用個(gè)人頁UI管理公眾號(hào)
到此這篇關(guān)于Golang實(shí)現(xiàn)微信公眾號(hào)后臺(tái)接入的示例代碼的文章就介紹到這了,更多相關(guān)Golang微信公眾號(hào)后臺(tái)內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家!
相關(guān)文章
重學(xué)Go語言之?dāng)?shù)組的具體使用詳解
Go的數(shù)組是一種復(fù)合數(shù)據(jù)類型,在平時(shí)開發(fā)中并不常用,更常用的是切片(slice),可以把切片看作是能動(dòng)態(tài)擴(kuò)容的數(shù)組,切片的底層數(shù)據(jù)結(jié)構(gòu)就是數(shù)組,所以數(shù)組雖不常用,但仍然有必要掌握2023-02-02Go語言實(shí)現(xiàn)可選參數(shù)的方法小結(jié)
這篇文章主要為大家詳細(xì)介紹了Go語言實(shí)現(xiàn)可選參數(shù)的一些常見方法,文中的示例代碼講解詳細(xì),感興趣的小伙伴可以跟隨小編一起學(xué)習(xí)一下2024-02-02golang使用 gomodule 在公共測(cè)試環(huán)境管理go的依賴的實(shí)例詳解
這篇文章主要介紹了golang使用 gomodule 在公共測(cè)試環(huán)境管理go的依賴,本文給大家介紹的非常詳細(xì),對(duì)大家的學(xué)習(xí)或工作具有一定的參考借鑒價(jià)值,需要的朋友可以參考下2020-11-11如何使用Golang創(chuàng)建與讀取Excel文件
我最近工作忙于作圖,圖表,需要自己準(zhǔn)備數(shù)據(jù)源,所以經(jīng)常和Excel打交道,下面這篇文章主要給大家介紹了關(guān)于如何使用Golang創(chuàng)建與讀取Excel文件的相關(guān)資料,需要的朋友可以參考下2022-07-07Go?語言進(jìn)階freecache源碼學(xué)習(xí)教程
這篇文章主要為大家介紹了Go?語言進(jìn)階freecache源碼學(xué)習(xí)教程,有需要的朋友可以借鑒參考下,希望能夠有所幫助,祝大家多多進(jìn)步,早日升職加薪2023-04-04