消息推送

　　開發者服務器接收消息推送

　　開發者需要按照如下步驟完成：

　　填寫服務器配置

　　驗證服務器地址的有效性

　　據接口文檔實現業務邏輯，接收消息和事件

　　第一步：填寫服務器配置

　　登錄視頻號小店后臺后，在「服務市場」-「自研」-「消息推送」中，啟用消息服務，填寫服務器地址(URL)、令牌(Token) 和 消息加密密鑰(EncodingAESKey)等信息。(只有小店管理員才可以操作)

　　URL: 開發者用來接收微信消息和事件的接口 URL。開發者所填寫的URL 必須以 http:// 或 https:// 開頭，分別支持 80 端口和 443 端口。

　　Token: 可由開發者可以任意填寫，用作生成簽名(該 Token 會和接口 URL 中包含的 Token 進行比對，從而驗證安全性)。

　　EncodingAESKey: 由開發者手動填寫或隨機生成，將用作消息體加解密密鑰。

　　注意，不再支持明文模式和混合模式，僅支持純密文模式。 加解密請參考消息加解密說明

　　注意，不再支持xml格式，僅支持JSON格式。

　　模式的選擇與服務器配置在提交后都會立即生效，請開發者謹慎填寫及選擇。

　　第二步：驗證消息的確來自微信服務器

　　開發者提交信息后，微信服務器將發送 GET 請求到填寫的服務器地址 URL 上，GET請求攜帶參數如下表所示：

　　參數描述

　　signature微信加密簽名，signature結合了開發者填寫的 token 參數和請求中的 timestamp 參數、nonce參數。

　　timestamp時間戳

　　nonce隨機數

　　echostr隨機字符串

　　開發者通過檢驗 signature 對請求進行校驗(下面有校驗方式)。若確認此次 GET 請求來自微信服務器，請原樣返回 echostr 參數內容，則接入生效，成為開發者成功，否則接入失敗。加密/校驗流程如下：

　　將token、timestamp、nonce三個參數進行字典序排序

　　將三個參數字符串拼接成一個字符串進行sha1加密

　　開發者獲得加密后的字符串可與 signature 對比，標識該請求來源于微信

　　驗證 URL 有效性成功后即接入生效，成為開發者。

　　檢驗 signature 的PHP示例代碼：

　　private function checkSignature()

　　{

　　$signature = $_GET["signature"];

　　$timestamp = $_GET["timestamp"];

　　$nonce = $_GET["nonce"];

　　$token = TOKEN;

　　$tmpArr = array($token, $timestamp, $nonce);

　　sort($tmpArr, SORT_STRING);

　　$tmpStr = implode( $tmpArr );

　　$tmpStr = sha1( $tmpStr );

　　if ($tmpStr == $signature ) {

　　return true;

　　} else {

　　return false;

　　}

　　}

　　PHP示例代碼下載：下載

　　第三步：接收消息和事件

　　當某些特定的用戶操作引發事件推送時，微信服務器會將消息(或事件)的數據包以 POST 請求發送到開發者配置的 URL，開發者可以依據自身業務邏輯進行響應。

　　微信服務器在將用戶的消息發給開發者服務器地址后，微信服務器在五秒內收不到響應會斷掉連接，并且重新發起請求，總共重試三次。如果在調試中，發現用戶無法收到響應的消息，可以檢查是否消息處理超時。關于重試的消息排重，有 msgid 的消息推薦使用 msgid 排重。事件類型消息推薦使用 FromUserName + CreateTime 排重。

　　服務器收到請求必須做出下述回復，這樣微信服務器才不會對此作任何處理，并且不會發起重試，否則，將出現嚴重的錯誤提示。詳見下面說明：

　　直接回復success(推薦方式)

　　直接回復空串(指字節長度為0的空字符串，而不是結構體中 content 字段的內容為空)

　　若接口文檔有指定返回內容，應按文檔說明返回