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

1、W微信公眾輕激口 API指南簡介微信公眾平臺消息接口為開發(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ā)復(fù)式 > 成為開發(fā)者成為開發(fā)者后f你才可毆便用公處平臺的開著功尬 需要填寫URL和Token r這兩項信息需要吩掏有自己的接口配青信

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

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

4、sgType></xml>參數(shù)描述1ToUserName開發(fā)者微信號FromUserNamee發(fā)送方帳號（一個 OpenID）CreateTime消息創(chuàng)建時間（整型）1MsgTypetextContent文本消息內(nèi)容MsgId消息id，64位整型圖片消息<xml><ToUserName>v!CDATAtoUserx/ToUserName> <FromUserName><!CDATAfromUserx/FromUserName> <CreateTime>1348831860</CreateTime>&

5、lt;MsgType><!CDATAimagex/MsgType><PicUrlx!CDATAthis is a urlx/PicUrl></xml>參數(shù)描述ToUserName開發(fā)者微信號1FromUserNamee發(fā)送方帳號（一個 OpenID）CreateTime消息創(chuàng)建時間（整型）MsgTypeimagePicUrl圖片鏈接MsgId消息id，64位整型地理位置消息<xml><ToUserName>v!CDATAtoUserx/ToUserName><FromUserName>v!CDATAfromUs

6、erx/FromUserName><CreateTime>1351776360</CreateTime><MsgType><!CDATAlocati on ></MsgType><Location_X>23.134521</Location_X> <Location_Y>113.358803</Location_Y> <Scale>20</Scale><Label>v!CDATA位置信息>v/Label>參數(shù)描述ToUserName開

7、發(fā)者微信號1FromUserNamee發(fā)送方帳號（一個 OpenID）CreateTime消息創(chuàng)建時間（整型）rMsgTypelocatio n1Locati on_X地理位置維度Locati on_Y地理位置經(jīng)度1Scale地圖縮放大小Label地理位置信息MsgId消息id，64位整型鏈接消息<xml><ToUserName>v!CDATAtoUserx/ToUserName> <FromUserName>v!CDATAfromUserx/FromUserName> <CreateTime>1351776360</Creat

8、eTime><MsgType><!CDATAli nkx/MsgType><Title><!CDATA公眾平臺官網(wǎng)鏈接>v/Title><Description><!CDATA公眾平臺官網(wǎng)鏈接></Description><Url>v!CDATAurlx/Url></xml>參數(shù)描述ToUserName接收方微信號FromUserNamc?發(fā)送方微信號，若為普通用戶，則是一個Ope nIDCreateTime消息創(chuàng)建時間MsgType消息類型，linkTitle消息標(biāo)題

9、Descriptio n消息描述Url消息鏈接MsgId消息id，64位整型事件推送事件推送只支持微信4.5版本，即將開放，敬請期待。<xml><ToUserName>v!CDATAtoUserx/ToUserName><FromUserName><!CDATAfromUserx/FromUserName> <CreateTime>123456789</CreateTime><MsgType><!CDATAeve ntx/MsgType><Eve nt><!CDATALOCA

10、TIONx/Eve nt><Latitude>23.137466</Latitude><Lo ngitude>113.352425</Lo ngitude>vPrecisio n>119.385040</Precisio n></xml>參數(shù)描述ToUserName接收方微信號FromUserName?發(fā)送方微信號，若為普通用戶，則是一個Ope nIDCreateTime消息創(chuàng)建時間MsgType消息類型，eve ntEve nt事件類型，有ENTER進(jìn)入會話）和LOCATION地理位置）Latitude地理位

11、置維度，事件類型為 LOCATIONS時存在Lon gitude地理位置經(jīng)度，事件類型為 LOCATIONS時存在Precisio n地理位置精度，事件類型為 LOCATIONS時存在消息回復(fù)對于每一個POST青求，開發(fā)者在響應(yīng)包中返回特定 xml結(jié)構(gòu)，對該消息進(jìn)行響 應(yīng)（現(xiàn)支持回復(fù)文本、圖文、語音、視頻、音樂和對收到的消息進(jìn)行星標(biāo)操作）。微信服務(wù)器在五秒內(nèi)收不到響應(yīng)會斷掉連接回復(fù)xml結(jié)構(gòu)如下：回復(fù)文本消息<xml><ToUserName>v!CDATAtoUserx/ToUserName> <FromUserName><!CDATAfromU

12、serx/FromUserName> <CreateTime>12345678</CreateTime><MsgType><!CDATAtextx/MsgType><Co nten t><!CDATAco nte ntx/Co nte nt><Fun cFlag>0</Fun cFlag></xml>參數(shù)描述ToUserName接收方帳號（收到的OpenID）FromUserName夕開發(fā)者微信號CreateTime消息創(chuàng)建時間MsgTypetextContent回復(fù)的消息內(nèi)容Fu

13、n cFlag位0x0001被標(biāo)志時，星標(biāo)剛收到的消息?；貜?fù)音樂消息<xml><ToUserName><!CDATAtoUserx/ToUserName> <FromUserName><!CDATAfromUserx/FromUserName> <CreateTime>12345678</CreateTime><MsgType><!CDATAmusicx/MsgType><Music><Title>v!CDATATITLEx/Title><Descri

14、ptio n> <!CDATADESCRIPTION></Descriptio n> <MusicUrl>v!CDATAMUSIC_Urlx/MusicUrl> <HQMusicUrl>v!CDATAHQ_MUSIC_Urlx/HQMusicUrl> </Music><Fun cFlag>0</Fun cFlag></xml>參數(shù)描述ToUserName接收方帳號（收到的OpenID）FromUserName?開發(fā)者微信號CreateTime消息創(chuàng)建時間MsgTypemusicMu

15、sicUrl音樂鏈接HQMusicUrl高質(zhì)量音樂鏈接，WIFI環(huán)境優(yōu)先使用該鏈接播放音樂Fun cFlag位0x0001被標(biāo)志時，星標(biāo)剛收到的消息?；貜?fù)圖文消息<xml><ToUserName>v!CDATAtoUserx/ToUserName><FromUserName><!CDATAfromUserx/FromUserName> <CreateTime>12345678</CreateTime><MsgType><!CDATA newsx/MsgType>vArticleCou nt&g

16、t;2</ArticleCou nt><Articles><item><Title>v!CDATAtitle1x/Title><Descriptio n> <!CDATAdescriptio n1x/Descriptio n><PicUrl>v!CDATApicurlx/PicUrl> <Url>v!CDATAurlx/Url></item><item><Title><!CDATAtitle></Title><Descripti on> <!CDATAdescripti on ></Descripti on><PicUrl>v!CDATApicurlx/PicUrl><Url>v!CDATAurlx/Url></item></Articles><Fun cFlag>1</Fun cFlag></xml>參數(shù)描述ToUserName接收方帳號（收到的Ope nID）FromUserName夕開發(fā)者微信號CreateTime消息創(chuàng)建時間MsgTypen ewsArtic