微信公眾平臺消息接口API指南

1、簡介微信公眾平臺消息接口為開發(fā)者提供了一種新的消息處理方式。微信公眾平臺消息接口為開發(fā)者提供與用戶進(jìn)行消息交互的能力。對于成功接入消息接口的微信公眾賬號，當(dāng)用戶發(fā)消息給公眾號，微信公眾平臺服務(wù)器會使用http請求對接入的網(wǎng)址進(jìn)行消息推送，第三方服務(wù)器可通過響應(yīng)包回復(fù)特定結(jié)構(gòu)，從而達(dá)到回復(fù)消息的目的。申請消息接口點擊中請，填寫網(wǎng)址url和token,其中token可由開發(fā)者可以任意填寫，用作生成簽名。高級功能>開發(fā)統(tǒng)式>成為開發(fā)春成為笄發(fā)者后r你才可以情司公眾平臺的開發(fā)功能.需要填寫URL和Token.這兩班信息需妾你擁有自己的接口配置信息URL輸入URL|必須以httpy出頭，目前

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

3、nonce三個參數(shù)進(jìn)行字典序排序2 .將三個參數(shù)字符串拼接成一個字符串進(jìn)行sha1加密3 .開發(fā)者獲得加密后的字符串可與signature對比，標(biāo)識該請求來源于微信消息推送當(dāng)普通微信用戶向公眾賬號發(fā)消息時，微信服務(wù)器將POST亥消息到填寫的URL上。結(jié)構(gòu)如下：文本消息<xml><ToUserName><!CDATAtoUser></ToUserName><FromUserName><!CDATAfromUser></FromUserName><CreateTime>1348831860</Cr

4、eateTime><MsgType><!CDATAtext></MsgType><Content><!CDATAthisisatest></Content><MsgId>1234567890123456</MsgId></xml>參數(shù)描述ToUserName開發(fā)者微信號FromUserNam(e發(fā)送力帳號（一個OpenlD）CreateTime消息創(chuàng)建時間（整型）MsgTypetextContent文本消息內(nèi)容MsgId消息id,64位整型圖片消息<xml><To

5、UserName><!CDATAtoUser></ToUserName><FromUserName><!CDATAfromUser></FromUserName><CreateTime>1348831860</CreateTime><MsgType><!CDATAimage></MsgType><PicUrl><!CDATAthisisaurl></PicUrl><MsgId>1234567890123456</Ms

6、gId></xml>參數(shù)描述ToUserName開發(fā)者微信號1FromUserNam(e發(fā)送力帳號（一個OpenlD）CreateTime消息創(chuàng)建時間（整型）MsgTypeimagePicUrl圖片鏈接MsgId消息id,64位整型地理位置消息<xml><ToUserName><!CDATAtoUser></ToUserName><FromUserName><!CDATAfromUser></FromUserName><CreateTime>1351776360</Creat

7、eTime><MsgType><!CDATAlocation></MsgType><Location_X>23.134521</Location_X><Location_Y>113.358803</Location_Y><Scale>20</Scale><Label><!CDATA位置信息></Label><MsgId>1234567890123456</MsgId></xml>參數(shù)描述ToUserName開發(fā)

8、者微信號1FromUserNam(e發(fā)送力帳號（一個OpenlD）CreateTime消息創(chuàng)建時間（整型）1MsgTypelocationLocation_X地理位置維度Location_Y地理位置經(jīng)度1Scale地圖縮放大小Label地理位置信息MsgId消息id,64位整型鏈接消息<xml><ToUserName><!CDATAtoUser></ToUserName><FromUserName><!CDATAfromUser></FromUserName><CreateTime>13517763

9、60</CreateTime><MsgType><!CDATAlink></MsgType><Title><!CDATA公眾平臺官網(wǎng)鏈接></Title><Description><!CDATA公眾平臺官網(wǎng)鏈接></Description><Url><!CDATAurl></Url><MsgId>1234567890123456</MsgId></xml>參數(shù)描述ToUserName接收方微信號FromU

10、serNam(e發(fā)送方微信號，若為普通用戶，則是一個OpenlDCreateTime消息創(chuàng)建時間MsgType消息類型,linkTitle消息標(biāo)題Description消息描述Url消息鏈接MsgId消息id,64位整型事件推送事件推送只支持微信4.5版本，即將開放，敬請期待。<xml><ToUserName><!CDATAtoUser></ToUserName><FromUserName><!CDATAfromUser></FromUserName><CreateTime>123456789<

11、;/CreateTime><MsgType><!CDATAevent></MsgType><Event><!CDATALOCATION></Event><Latitude>23.137466</Latitude><Longitude>113.352425</Longitude><Precision>119.385040</Precision></xml>參數(shù)描述ToUserName接收方微信號FromUserNamce發(fā)送方微信號，若

12、為普通用戶，則是一個OpenIDCreateTime消息創(chuàng)建時間MsgType消息類型，eventEvent事件類型，有ENTER®入會話）和LOCATION理位置）Latitude地理位置維度，事件類型為LOCATIO的時存在Longitude地理位置經(jīng)度，事件類型為LOCATIO的時存在Precision地理位置精度，事件類型為LOCATIO的時存在消息回復(fù)對于每一個POST青求，開發(fā)者在響應(yīng)包中返回特定xml結(jié)構(gòu)，對該消息進(jìn)行響應(yīng)（現(xiàn)支持回復(fù)文本、圖文、語音、視頻、音樂和對收到的消息進(jìn)行星標(biāo)操作）c微信服務(wù)器在五秒內(nèi)收不到響應(yīng)會斷掉連接。回復(fù)xml結(jié)構(gòu)如下:回復(fù)文本消息<

13、xml><ToUserName><!CDATAtoUser></ToUserName><FromUserName><!CDATAfromUser></FromUserName><CreateTime>12345678</CreateTime><MsgType><!CDATAtext></MsgType><Content><!CDATAcontent></Content><FuncFlag>0</FuncF

14、lag></xml>參數(shù)描述ToUserName接收方帳號（收到的OpenID）FromUserName開發(fā)者微信號CreateTime消息創(chuàng)建時間MsgTypetextContent回復(fù)的消息內(nèi)容FuncFlag位0x0001被標(biāo)志時，星標(biāo)剛收到的消息?；貜?fù)音樂消息<xml><ToUserName><!CDATAtoUser></ToUserName><FromUserName><!CDATAfromUser></FromUserName><CreateTime>12345678

15、</CreateTime><MsgType><!CDATAmusic></MsgType><Music><Title><!CDATATITLE></Title><Description><!CDATADESCRIPTION></Description><MusicUrl><!CDATAMUSIC_Url></MusicUrl><HQMusicUrl><!CDATAHQ_MUSIC_Url></HQM

16、usicUrl></Music><FuncFlag>0</FuncFlag></xml>參數(shù)描述ToUserName接收方帳號（收到的OpenID）FromUserNams?開發(fā)者微信號CreateTime消息創(chuàng)建時間MsgTypemusicMusicUrl音樂鏈接HQMusicUrl高質(zhì)量音樂鏈接，WIFI環(huán)境優(yōu)先使用該鏈接播放音樂FuncFlag位0x0001被標(biāo)志時，星標(biāo)剛收到的消息。回復(fù)圖文消息<xml><ToUserName><!CDATAtoUser></ToUserName>&l

17、t;FromUserName><!CDATAfromUser></FromUserName><CreateTime>12345678</CreateTime><MsgType><!CDATAnews></MsgType><ArticleCount>2</ArticleCount><Articles><item><Title><!CDATAtitle1></Title><Description><!CDAT

18、Adescription1></Description><PicUrl><!CDATApicurl></PicUrl><Url><!CDATAurl></Url></item><item><Title><!CDATAtitle></Title><Description><!CDATAdescription></Description><PicUrl><!CDATApicurl></PicUrl><Url><!CDATAurl></Url></item></Articles><FuncFlag>1</FuncFlag></xml>參數(shù)描述ToUserName接收方帳號（收到的OpenID）FromUserName，開發(fā)者微信號