一、簡介
公眾平臺消息接口為開發(fā)者提供了一種新的消息處理方式。
二、申請消息接口
點(diǎn)擊申請,如實(shí)填寫負(fù)責(zé)人姓名 、 手機(jī)號和郵箱,填寫網(wǎng)址url和token,其中token可由開發(fā)者可以任意填寫,用作生成簽名。
三、網(wǎng)址接入
公眾平臺用戶提交信息后,我們將以GET請求方式請求到填寫的Url上,并且?guī)纤膫€參數(shù):
* signature — 微信加密簽名
* timestamp — 時間戳
* 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ā)者填寫的token參數(shù)、timestamp參數(shù)和nonce參數(shù)等,加密流程:
* 將token、timestamp、nonce三個參數(shù)進(jìn)行字典序排序
* 將三個參數(shù)字符串拼接成一個字符串進(jìn)行sha1加密
* 開發(fā)者獲得加密后的字符串可與signature對比,標(biāo)識該請求來源于微信。
四、消息推送
當(dāng)普通微信用戶向公眾賬號發(fā)消息時,公眾平臺將POST該消息到填寫的Url上(現(xiàn)支持文本消息以及地理位置消息)。結(jié)構(gòu)如下:
文本消息xml格式
<xml><ToUserName><![CDATA[toUser]]></ToUserName><FromUserName><![CDATA[fromUser]]></FromUserName><CreateTime>1348831860</CreateTime><MsgType><![CDATA[text]]></MsgType><Content><![CDATA[this is a test]]></Content></xml>
ToUserName 消息接收方微信號,一般為公眾平臺賬號微信號
FromUserName 消息發(fā)送方微信號
CreateTime 消息創(chuàng)建時間
MsgType 文本消息為text
Content 消息內(nèi)容
地理位置消息xml格式
<xml><ToUserName><![CDATA[toUser]]></ToUserName><FromUserName><![CDATA[fromUser]]></FromUserName><CreateTime>1351776360</CreateTime><MsgType><![CDATA[location]]></MsgType><Location_X>23.134521</Location_X><Location_Y>113.358803</Location_Y><Scale>20</Scale><Label><![CDATA[位置信息]]></Label></xml>
ToUserName 消息接收方微信號,一般為公眾平臺賬號微信號
FromUserName 消息發(fā)送方微信號
CreateTime 消息創(chuàng)建時間
MsgType 消息類型,地理位置為location
Location_X 地理位置緯度
Location_Y 地理位置經(jīng)度
Scale 地圖縮放大小
Label 地理位置信息
圖片消息結(jié)構(gòu)
<xml><ToUserName><![CDATA[toUser]]></ToUserName><FromUserName><![CDATA[fromUser]]></FromUserName><CreateTime>1348831860</CreateTime><MsgType><![CDATA[image]]></MsgType><PicUrl><![CDATA[this is a url]></PicUrl></xml>
ToUserName 消息接收方微信號,一般為公眾平臺賬號微信號
FromUserName 消息發(fā)送方微信號
CreateTime 消息創(chuàng)建時間
MsgType 消息類型image
PicUrl 圖片鏈接,開發(fā)者可以用HTTP GET獲取
五、消息回復(fù)
對于每一個POST請求,開發(fā)者在響應(yīng)包中返回特定xml結(jié)構(gòu),對該消息進(jìn)行相應(yīng)操作(現(xiàn)支持回復(fù)文本消息 、 回復(fù)圖文消息和星標(biāo)操作)。xml結(jié)構(gòu)如下:
回復(fù)文本消息格式
<xml><ToUserName><![CDATA[toUser]]></ToUserName><FromUserName><![CDATA[fromUser]]></FromUserName><CreateTime>12345678</CreateTime><MsgType><![CDATA[text]]></MsgType><Content><![CDATA[content]]></Content><FuncFlag>0</FuncFlag></xml>
FromUserName 消息發(fā)送方
ToUserName 消息接收方
CreateTime 消息創(chuàng)建時間
MsgType 消息類型,文本消息必須填寫text
Content 消息內(nèi)容,大小限制在2048字節(jié),字段為空為不合法請求
回復(fù)圖文消息格式
<xml><ToUserName><![CDATA[toUser]]></ToUserName><FromUserName><![CDATA[fromUser]]></FromUserName><CreateTime>12345678</CreateTime><MsgType><![CDATA[news]]></MsgType><Content><![CDATA[]]></Content><ArticleCount>2</ArticleCount><Articles><item><Title><![CDATA[title1]]></Title><Description><![CDATA[description1]]></Description><PicUrl><![CDATA[picurl]]></PicUrl><Url><![CDATA[url]]></Url></item><item><Title><![CDATA[title]]></Title><Description><![CDATA[description]]></Description><PicUrl><![CDATA[picurl]]></PicUrl><Url><![CDATA[url]]></Url></item></Articles><FuncFlag>1</FuncFlag></xml>
FromUserName 消息發(fā)送方
ToUserName 消息接收方
CreateTime 消息創(chuàng)建時間
MsgType 消息類型,圖文消息必須填寫news
Content 消息內(nèi)容,圖文消息可填空
ArticleCount 圖文消息個數(shù),限制為10條以內(nèi)
Articles 多條圖文消息信息,默認(rèn)第一個item為大圖
Title 圖文消息標(biāo)題
Description 圖文消息描述
PicUrl 圖片鏈接,支持JPG、PNG格式,較好的效果為大圖640*320,小圖80*80,限制圖片鏈接的域名需要與開發(fā)者填寫的基本資料中的Url一致
Url 點(diǎn)擊圖文消息跳轉(zhuǎn)鏈接
星標(biāo)消息
在xml結(jié)構(gòu)中,有一個FuncFlag字段,開發(fā)者可以通過填寫FuncFlag字段為1來對消息進(jìn)行星標(biāo),你可以在實(shí)時消息的星標(biāo)消息分類中找到該消息
新聞熱點(diǎn)
疑難解答
圖片精選