寫在前面

回想起來今年還沒有在CSDN上發過文章，草稿箱裡積攢了很多話題，可由於時間關係最終也沒發出來。不能再拖了，打算寫個系列專題，聊聊微信接入。

隨著微信使用者量的不斷增加，越來越多的企業也將自己的服務加入到了微信當中。微信本身提供的公眾號、服務號的基礎功能難以滿足日趨增長的需求，於是微信為我們打開了一整套自定義功能的API，利用這些API，我們可以彌補原有平臺的不足，創造出更加方便的功能。本篇先對微信介面進行簡單的介紹。

騰訊雖然官方也提供了很多語言版本的開發包（參閱：http://qydev.weixin.qq.com/wiki/index.php?title=加解密庫下載與返回碼），包括C++、Python、php、java和C#，但是筆者發現作為以PHP為主導技術的公司，Java版本的SDK無論是從封裝效能、可維護性還是語法結構上都不夠嚴謹。也正是因此才有了做一套開源API適配庫的想法，目的就是為了讓微信接入更簡單、更容易維護（專案地址為：

任何新技術的掌握都是從文件開始的，如果你剛剛接觸微信接入開發，不妨先看看官方的文件：https://mp.weixin.qq.com/wiki（這個地址後來發現有點問題，可能是啟用了refer遮蔽，從部落格跳轉過去會報錯，隨便點個報錯頁面的連結，貼上地址後即可訪問）

通過閱讀文件，我們大概將微信介面分為兩類：被動回撥（集中在文件的訊息管理部分）介面和主動呼叫介面。

被動回撥介面

嚴格意義上來說，該介面的業務邏輯是由我們自定義的。當有相應的事件發生時，微信會按照之前配置好的公眾平臺引數主動請求你的介面。請求引數和請求體都是在文件中明確宣告的，我們要做的就是對其進行適配。

該介面的作用類似於簡訊中心。當用戶訂閱了你的公眾號之後可以向其主動傳送資訊，但訊息不是直接到達了你的後臺系統，而是通過微信的轉發回撥機制，將內容通過統一的格式傳送給接入的後臺系統。你是否還記得有些電視節目中參與互動，發特定的簡訊內容到一個服務號碼上就能參與進去？道理是一樣的。

若需要使用回撥介面，需要在正式使用前對賬號進行配置。方法為：登入微信公眾號平臺. 登入地址:https://mp.weixin.qq.com/，檢視自己的公眾號。

a.若使用正式公眾號除錯，請在左側選單中找到”開發”->”基本配置”->”開發者ID”和”伺服器配置”中找到對應的配置項。

b.若使用公眾號的測試賬號除錯，請在左側選單中找到”開發”->”開發者工具”->”公眾平臺測試帳號”->”進入”->掃描登入二維碼->”測試號資訊”和”介面配置資訊”中找到對應的配置項。

一個通常的業務模式為下圖所示

上述場景中，公眾號處於被動模式，只有使用者主動傳送訊息，才會觸發微信回撥公眾號後臺，併產生相應的應答。實際應用場景有：“回覆XX給你看一張圖”，“給我們的節目留言”等等。

關於該處的配置和除錯方法將會在後續章節中詳細介紹

主動呼叫介面

剛剛我們說過使用者主動向公眾號傳送訊息，那麼有沒有主動發訊息給使用者的場景呢？例如：告警系統，機房中哪臺機器出現問題我們事先是不知道的，監測到異常時需要主動發訊息通知使用者。那麼就涉及到了主動呼叫類介面了。這部分介面包羅永珍，是微信介面的重點和難點。

微信官方針對主動呼叫的介面進行了一些列限制，例如公眾號不能給未關注該號的使用者傳送訊息（旨在保護使用者不被惡意打擾），例如API訪問令牌Token，每天的獲取次數也根據公眾號的型別做了不同的限制。

一個通常的業務模式為下圖所示

具體實踐，後續章節中也會對其進行介紹。

本節對微信介面進行了分類和原理的粗略解釋，更多內容請關注我的部落格，也歡迎針對該開源框架提出改進性建議。