微信公眾平臺開發(fā)接口

1、微信公眾平臺開發(fā)接口一、 消息接口 消息接口指南二、 通用接口 接口文檔三、 自定義菜單接口 接口文檔四、 使用限制 接口權限五、 返回碼說明消息接口指南返回出自開放平臺跳轉到： 導航, 搜索目錄隱藏 1 簡介 2 申請消息接口 3 網(wǎng)址接入 4 消息推送o 4.1 文本消息o 4.2 圖片消息o 4.3 地理位置消息o 4.4 鏈接消息o 4.5 事件推送 5 消息回復o 5.1 回復文本消息o 5.2 回復音樂消息o 5.3 回復圖文消息 6 注意事項 7 示例代碼簡介公眾平臺消息接口為開發(fā)者提供了一種新的消息處理方式。申請消息接口點擊申請，填寫網(wǎng)址url和token，其中token可由開

2、發(fā)者可以任意填寫，用作生成簽名。網(wǎng)址接入公眾平臺用戶提交信息后，微信服務器將發(fā)送GET請求到填寫的URL上，并且?guī)纤膫€參數(shù)：參數(shù)描述signature微信加密簽名timestamp時間戳nonce隨機數(shù)echostr隨機字符串開發(fā)者通過檢驗signature對請求進行校驗（下面有校驗方式）。若確認此次GET請求來自微信服務器，請原樣返回echostr參數(shù)內(nèi)容，則接入生效，否則接入失敗。 signature結合了開發(fā)者填寫的token參數(shù)和請求中的timestamp參數(shù)、nonce參數(shù)。加密/校驗流程：1. 將token、timestamp、nonce三個參數(shù)進行字典序排序2. 將三個參數(shù)字符

3、串拼接成一個字符串進行sha1加密3. 開發(fā)者獲得加密后的字符串可與signature對比，標識該請求來源于微信消息推送當普通微信用戶向公眾賬號發(fā)消息時，微信服務器將POST該消息到填寫的URL上。結構如下：文本消息 1348831860 1234567890123456 參數(shù)描述ToUserName開發(fā)者微信號FromUserName發(fā)送方帳號（一個OpenID）CreateTime消息創(chuàng)建時間 （整型）MsgTypetextContent文本消息內(nèi)容MsgId消息id，64位整型圖片消息 1348831860 1234567890123456 參數(shù)描述ToUserName開發(fā)者微信號Fro

4、mUserName發(fā)送方帳號（一個OpenID）CreateTime消息創(chuàng)建時間 （整型）MsgTypeimagePicUrl圖片鏈接MsgId消息id，64位整型地理位置消息135177636023.134521113.358803201234567890123456 參數(shù)描述ToUserName開發(fā)者微信號FromUserName發(fā)送方帳號（一個OpenID）CreateTime消息創(chuàng)建時間 （整型）MsgTypelocationLocation_X地理位置緯度Location_Y地理位置經(jīng)度Scale地圖縮放大小Label地理位置信息MsgId消息id，64位整型鏈接消息13517763

5、601234567890123456 參數(shù)描述ToUserName接收方微信號FromUserName發(fā)送方微信號，若為普通用戶，則是一個OpenIDCreateTime消息創(chuàng)建時間MsgType消息類型，linkTitle消息標題Description消息描述Url消息鏈接MsgId消息id，64位整型事件推送事件推送只支持微信4.5版本，目前開啟自定義菜單接口事件推送、關注與取消關注事件推送。其余功能即將開放，敬請期待。 123456789參數(shù)描述ToUserName接收方微信號FromUserName發(fā)送方微信號，若為普通用戶，則是一個OpenIDCreateTime消息創(chuàng)建時間MsgT

6、ype消息類型，eventEvent事件類型，subscribe(訂閱)、unsubscribe(取消訂閱)、CLICK(自定義菜單點擊事件)EventKey事件KEY值，與自定義菜單接口中KEY值對應消息回復對于每一個POST請求，開發(fā)者在響應包中返回特定xml結構，對該消息進行響應（現(xiàn)支持回復文本、圖文、語音、視頻、音樂和對收到的消息進行星標操作）。 微信服務器在五秒內(nèi)收不到響應會斷掉連接?；貜蛒ml結構如下：回復文本消息 12345678 0 參數(shù)描述ToUserName接收方帳號（收到的OpenID）FromUserName開發(fā)者微信號CreateTime消息創(chuàng)建時間MsgTypete

7、xtContent回復的消息內(nèi)容,長度不超過2048字節(jié)FuncFlag位0x0001被標志時，星標剛收到的消息?；貜鸵魳废?12345678 0 參數(shù)描述ToUserName接收方帳號（收到的OpenID）FromUserName開發(fā)者微信號CreateTime消息創(chuàng)建時間MsgTypemusicMusicUrl音樂鏈接HQMusicUrl高質量音樂鏈接，WIFI環(huán)境優(yōu)先使用該鏈接播放音樂FuncFlag位0x0001被標志時，星標剛收到的消息?；貜蛨D文消息 12345678 2 1 參數(shù)描述ToUserName接收方帳號（收到的OpenID）FromUserName開發(fā)者微信號Creat

8、eTime消息創(chuàng)建時間MsgTypenewsArticleCount圖文消息個數(shù)，限制為10條以內(nèi)Articles多條圖文消息信息，默認第一個item為大圖Title圖文消息標題Description圖文消息描述PicUrl圖片鏈接，支持JPG、PNG格式，較好的效果為大圖640*320，小圖80*80。Url點擊圖文消息跳轉鏈接注意事項1.用戶OpenID對一個公眾號是固定唯一的串2.請使用80端口示例代碼PHP：下載=PHP 示例代碼=valid();class wechatCallbackapiTestpublic function valid() $echoStr = $_GETech

9、ostr; /valid signature , option if($this-checkSignature() echo $echoStr; exit; public function responseMsg() /get post data, May be due to the different environments$postStr = $GLOBALSHTTP_RAW_POST_DATA; /extract post dataif (!empty($postStr) $postObj = simplexml_load_string($postStr, SimpleXMLEleme

10、nt, LIBXML_NOCDATA); $fromUsername = $postObj-FromUserName; $toUsername = $postObj-ToUserName; $keyword = trim($postObj-Content); $time = time(); $textTpl = %s0; if(!empty( $keyword ) $msgType = text; $contentStr = Welcome to wechat world!; $resultStr = sprintf($textTpl, $fromUsername, $toUsername,

11、$time, $msgType, $contentStr); echo $resultStr; else echo Input something.; else echo ; exit; private function checkSignature() $signature = $_GETsignature; $timestamp = $_GETtimestamp; $nonce = $_GETnonce; $token = TOKEN;$tmpArr = array($token, $timestamp, $nonce);sort($tmpArr);$tmpStr = implode( $

12、tmpArr );$tmpStr = sha1( $tmpStr );if( $tmpStr = $signature )return true;elsereturn false;?=end=通用接口文檔返回出自開放平臺跳轉到： 導航, 搜索簡介通用接口是使用HTTP請求，讓開發(fā)者直接與微信服務器交互，實現(xiàn)媒體文件上傳、媒體文件獲取等功能，達到獲取圖片、語音、視頻等媒體文件的目的。調(diào)用接口所需要的access_token必須通過獲取憑證接口獲取。獲取憑證接口說明在使用通用接口前，你需要做以下兩步工作：1.擁有一個微信公眾賬號，并獲取到appid和appsecret（在公眾平臺申請內(nèi)測資格，審核

13、通過后可獲得）2.通過獲取憑證接口獲取到access_token注意：access_token是第三方訪問api資源的票據(jù)；access_token對應于公眾號是全局唯一的票據(jù)，重復獲取將導致上次獲取的access_token失效。請求說明http請求方式: GET參數(shù)說明參數(shù)是否必須說明grant_type是獲取access_token填寫client_credentialappid是第三方用戶唯一憑證secret是第三方用戶唯一憑證密鑰，既appsecret返回說明正確的Json返回結果:access_token:ACCESS_TOKEN,expires_in:7200參數(shù)說明access

14、_token獲取到的憑證expires_in憑證有效時間，單位：秒錯誤的Json返回示例:errcode:40013,errmsg:invalid appid統(tǒng)一返回碼說明返回碼說明返回出自開放平臺跳轉到： 導航, 搜索返回碼說明返回碼說明-1系統(tǒng)繁忙0請求成功40001驗證失敗40002不合法的憑證類型40003不合法的OpenID40004不合法的媒體文件類型40005不合法的文件類型40006不合法的文件大小40007不合法的媒體文件id40008不合法的消息類型40009不合法的圖片文件大小40010不合法的語音文件大小40011不合法的視頻文件大小40012不合法的縮略圖文件大小40

15、013不合法的APPID40014不合法的access_token40014不合法的access_token40015不合法的菜單類型40016不合法的按鈕個數(shù)40017不合法的按鈕個數(shù)40018不合法的按鈕名字長度40019不合法的按鈕KEY長度40020不合法的按鈕URL長度40021不合法的菜單版本號40022不合法的子菜單級數(shù)40023不合法的子菜單按鈕個數(shù)40024不合法的子菜單按鈕類型40025不合法的子菜單按鈕名字長度40026不合法的子菜單按鈕KEY長度40027不合法的子菜單按鈕URL長度40028不合法的自定義菜單使用用戶41001缺少access_token參數(shù)41002

16、缺少appid參數(shù)41003缺少refresh_token參數(shù)41004缺少secret參數(shù)41005缺少多媒體文件數(shù)據(jù)41006缺少media_id參數(shù)41007缺少子菜單數(shù)據(jù)42001access_token超時43001需要GET請求43002需要POST請求43003需要HTTPS請求44001多媒體文件為空44002POST的數(shù)據(jù)包為空44003圖文消息內(nèi)容為空45001多媒體文件大小超過限制45002消息內(nèi)容超過限制45003標題字段超過限制45004描述字段超過限制45005鏈接字段超過限制45006圖片鏈接字段超過限制45007語音播放時間超過限制45008圖文消息超過限制45

17、009接口調(diào)用超過限制45010創(chuàng)建菜單個數(shù)超過限制46001不存在媒體數(shù)據(jù)46002不存在的菜單版本46003不存在的菜單數(shù)據(jù)47001解析JSON/XML內(nèi)容錯誤取自“窗體頂端自定義菜單接口返回出自開放平臺跳轉到： 導航, 搜索目錄隱藏 1 簡介 2 菜單創(chuàng)建 3 菜單查詢 4 菜單刪除簡介開發(fā)者獲取使用憑證（如何獲取憑證）后，可以使用該憑證對公眾賬號的自定義菜單進行創(chuàng)建、查詢和刪除等操作。 自定義菜單接口可實現(xiàn)以下類型按鈕：click（點擊事件）：用戶點擊click類型按鈕后，微信服務器會通過消息接口(event類型)推送點擊事件給開發(fā)者，并且?guī)习粹o中開發(fā)者填寫的key值，開發(fā)者可以通

18、過自定義的key值進行消息回復。創(chuàng)建自定義菜單后，由于微信客戶端緩存，需要24小時微信客戶端才會展現(xiàn)出來。建議測試時可以嘗試取消關注公眾賬號后，再次關注，則可以看到創(chuàng)建后的效果。菜單創(chuàng)建接口說明通過POST一個特定結構體，實現(xiàn)在微信客戶端創(chuàng)建自定義菜單。請求說明http請求方式：POST請求示例 button: type:click, name:今日歌曲, key:V1001_TODAY_MUSIC , type:click, name:歌手簡介, key:V1001_TODAY_SINGER , name:菜單, sub_button: type:click, name:hello word

19、, key:V1001_HELLO_WORLD , type:click, name:贊一下我們, key:V1001_GOOD 創(chuàng)建后效果:參數(shù)說明參數(shù)是否必須說明button是按鈕數(shù)組，按鈕個數(shù)應為23個sub_button否子按鈕數(shù)組，按鈕個數(shù)應為25個type是按鈕類型，目前有click類型name是按鈕描述，既按鈕名字，不超過16個字節(jié)，子菜單不超過40個字節(jié)key類型為click必須按鈕KEY值，用于消息接口(event類型)推送，不超過128字節(jié)返回說明正確的Json返回結果:errcode:0,errmsg:ok錯誤的Json返回結果errcode:40018,errmsg:invalid button name size統(tǒng)一返回碼說明菜單查詢接口說明查詢當前