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

1、一、簡介公眾平臺消息接口為開發(fā)者提供了一種新的消息處理方式。二、申請消息接口點(diǎn)擊申請，如實(shí)填寫負(fù)責(zé)人姓名、手機(jī)號和郵箱，填寫網(wǎng)址url 和 token ，其中 token可由開發(fā)者可以任意填寫，用作生成簽名。三、網(wǎng)址接入公眾平臺用戶提交信息后，我們將以GET 請求方式請求到填寫的Url 上，并且?guī)纤膫€(gè)參數(shù)：* signature 微信加密簽名* timestamp 時(shí)間戳* nonce 隨機(jī)數(shù)* echostr 隨機(jī)字符串開發(fā)者通過檢驗(yàn)signature對網(wǎng)址接入合法性進(jìn)行校驗(yàn)。若此次GET 請求原樣返回echostr參數(shù)內(nèi)容，則接入生效，否則接入失敗。驗(yàn)證 signature將結(jié)合開發(fā)者填

2、寫的 token參數(shù)、 timestamp參數(shù)和 nonce參數(shù)等，加密流程：* 將 token 、timestamp、 nonce三個(gè)參數(shù)進(jìn)行字典序排序* 將三個(gè)參數(shù)字符串拼接成一個(gè)字符串進(jìn)行sha1 加密* 開發(fā)者獲得加密后的字符串可與 signature 對比，標(biāo)識該請求來源于微信。四、消息推送當(dāng)普通微信用戶向公眾賬號發(fā)消息時(shí)，公眾平臺將POST 該消息到填寫的Url 上（現(xiàn)支持文本消息以及地理位置消息）。結(jié)構(gòu)如下：文本消息 xml格式<xml><ToUserName><!CDATAtoUser></ToUserName><FromU

3、serName><!CDATAfromUser></FromUserName><CreateTime>1348831860</CreateTime><MsgType><!CDATAtext></MsgType><Content><!CDATAthis is a test></Content></xml>ToUserName消息接收方微信號，一般為公眾平臺賬號微信號FromUserName消息發(fā)送方微信號CreateTime消息創(chuàng)建時(shí)間MsgType文本消息為

4、 textContent消息內(nèi)容地理位置消息xml 格式<xml><ToUserName><!CDATAtoUser></ToUserName><FromUserName><!CDATAfromUser></FromUserName><CreateTime>1351776360</CreateTime><MsgType><!CDATAlocation></MsgType><Location_X>23.134521</Location_

5、X><Location_Y>113.358803</Location_Y><Scale>20</Scale><Label><!CDATA位置信息 ></Label></xml>ToUserName消息接收方微信號，一般為公眾平臺賬號微信號FromUserName消息發(fā)送方微信號CreateTime消息創(chuàng)建時(shí)間MsgType消息類型，地理位置為locationLocation_X地理位置緯度Location_Y地理位置經(jīng)度Scale地圖縮放大小Label地理位置信息五、消息回復(fù)對于每一個(gè)POST

6、請求，開發(fā)者在響應(yīng)包中返回特定xml結(jié)構(gòu)，對該消息進(jìn)行相應(yīng)操作（現(xiàn)支持回復(fù)文本消息、回復(fù)圖文消息和星標(biāo)操作）。xml結(jié)構(gòu)如下：回復(fù)文本消息格式<xml><ToUserName><!CDATAtoUser></ToUserName><FromUserName><!CDATAfromUser></FromUserName><CreateTime>12345678</CreateTime><MsgType><!CDATAtext></MsgType><

7、Content><!CDATAcontent></Content><FuncFlag>0<FuncFlag></xml>FromUserName消息發(fā)送方ToUserName消息接收方CreateTime消息創(chuàng)建時(shí)間MsgType消息類型，文本消息必須填寫textContent消息內(nèi)容，大小限制在2048 字節(jié)，字段為空為不合法請求回復(fù)圖文消息格式<xml><ToUserName><!CDATAtoUser></ToUserName><FromUserName><

8、!CDATAfromUser></FromUserName><CreateTime>12345678</CreateTime><MsgType><!CDATAnews></MsgType><Content><!CDATA></Content><ArticleCount>2</ArticleCount><Articles><item><Title><!CDATAtitle1></Title><D

9、iscription><!CDATAdescription1></Discription><PicUrl><!CDATApicurl></PicUrl><Url><!CDATAurl></Url></item><item><Title><!CDATAtitle></Title><Discription><!CDATAdescription></Discription><PicUrl>&l

10、t;!CDATApicurl></PicUrl><Url><!CDATAurl></Url></item></Articles><FuncFlag>1<FuncFlag></xml>FromUserName消息發(fā)送方ToUserName消息接收方CreateTime消息創(chuàng)建時(shí)間MsgType消息類型，圖文消息必須填寫newsContent消息內(nèi)容，圖文消息可填空ArticleCount圖文消息個(gè)數(shù)，限制為10 條以內(nèi)Articles多條圖文消息信息，默認(rèn)第一個(gè)item為大圖Title圖文消息標(biāo)題Discription圖文消息描述PicUrl 圖片鏈接，支持 JPG、PNG格式，較好的效果為大圖 640*320，小圖 80*80 ，限制圖片鏈接的域 名需要與開發(fā)者填寫的基本資料中的 Url 一致Url點(diǎn)擊圖文消