微信公眾平台開發基本原則及訊息接

一、基本原理

在開始做之前，大家可能對這個很有興趣，但是又比較茫然。是不是很複雜？很難學啊？

其實恰恰相反，很簡單。為了打消大家的顧慮，先簡單介紹了微信公眾平台的基本原理。

微信伺服器就相當於一個轉送伺服器，終端機（手機、Pad等）發起請求至微信伺服器，微信伺服器，然後將請求轉送給自訂服務（這就裡就是我們的具體實作）。

服務處理完畢，然後揮發給微信伺服器，微信伺服器再將具體回應回復到終端。

通訊協定為：HTTP

資料格式為：XML

具體的流程如下圖所示：

其實，我們需要做的事情，就是對HTTP請求，做出回應。

具體的請求內容，我們依照特定的XML格式去解析，處理完畢後，也要依照特定的XML格式回傳。

我們只需要一個簡單的實作HttpHandler即可。

當然，微信平台還能實現更複雜的業務，例如微信可以作為內嵌的瀏覽器，我們可以透過微信的鏈接，打開htm介面，然後實現自己的邏輯。

 

二、訊息介面（官方文件）

#申請訊息介面

點選申請，填寫網址url和token，其中token可由開發者任意填寫，用作生成簽名。

網址接取

公眾平台用戶提交資訊後，微信伺服器將發送GET請求到填寫的URL上，並且帶上四個參數：

參數	描述
signature	微信加密簽章

開發者透過檢驗signature對請求進行校驗（下面有校驗方式）。若確認此GET請求來自微信伺服器，請原樣回傳echostr參數內容，則存取生效，否則存取失敗。 signature結合了開發者填入的token參數和請求中的timestamp參數、nonce參數。

加密/校验流程：
1. 将token、timestamp、nonce三个参数进行字典序排序
2. 将三个参数字符串拼接成一个字符串进行sha1加密
3. 开发者获得加密后的字符串可与signature对比，标识该请求来源于微信

 

#timestamp	時間戳
nonce	隨機數字
echostr	隨機字串

訊息推送

當普通微信用戶向公眾帳號發送訊息時，微信伺服器將POST該訊息到填寫的URL上。結構如下：ToUserName開發者##textContent文字訊息內容MsgId

文字訊息	<xml> <ToUserName><![CDATA[toUser]]></ToUserName> <FromUserName><![CDATA[fromUser]]></FromUserName> <CreateTime>1348831860</CreateTime> <MsgType><![CDATA[text]]></MsgType> <Content><![CDATA[this is a test]]></Content> <MsgId>1234567890123456</MsgId> </xml>
#參數	描述
	微訊號
#FromUserName	傳送方帳號（一個OpenID）
CreateTime	訊息建立時間（整數）
#MsgType

訊息id，64位元整數

圖片訊息

 <xml>
 <ToUserName><![CDATA[toUser]]></ToUserName>
 <FromUserName><![CDATA[fromUser]]></FromUserName>
 <CreateTime>1348831860</CreateTime>
 <MsgType><![CDATA[image]]></MsgType>
 <PicUrl><![CDATA[this is a url]]></PicUrl>
 <MsgId>1234567890123456</MsgId>
 </xml>

#參數描述開發者FromUserNameCreateTimeMsgType PicUrlMsgId##地理位置訊息

<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>
<MsgId>1234567890123456</MsgId>
</xml>

參數#描述##ToUserName

	##ToUserName
微訊號
傳送方帳號（一個OpenID）
訊息建立時間（整數）
image
圖片連結
#訊息id，64位元整數

###開發者###微訊號############FromUserName######發送方帳號（一個OpenID）############# CreateTime######訊息建立時間（整數）############MsgType######location###########Location_X### ###地理位置緯度############Location_Y######地理位置經度###########Scale######地圖縮放小############Label######地理位置資訊#############MsgId######訊息id，64位元整數## ##########

链接消息

<xml>
<ToUserName><![CDATA[toUser]]></ToUserName>
<FromUserName><![CDATA[fromUser]]></FromUserName>
<CreateTime>1351776360</CreateTime>
<MsgType><![CDATA[link]]></MsgType>
<Title><![CDATA[公众平台官网链接]]></Title>
<Description><![CDATA[公众平台官网链接]]></Description>
<Url><![CDATA[url]]></Url>
<MsgId>1234567890123456</MsgId>
</xml>

参数	描述
ToUserName	接收方微信号
FromUserName	发送方微信号，若为普通用户，则是一个OpenID
CreateTime	消息创建时间
MsgType	消息类型，link
Title	消息标题
Description	消息描述
Url	消息链接
MsgId	消息id，64位整型

事件推送

事件推送只支持微信4.5版本，目前开启自定义菜单接口事件推送、关注与取消关注事件推送。其余功能即将开放，敬请期待。

<xml><ToUserName><![CDATA[toUser]]></ToUserName>
<FromUserName><![CDATA[FromUser]]></FromUserName>
<CreateTime>123456789</CreateTime>
<MsgType><![CDATA[event]]></MsgType>
<Event><![CDATA[EVENT]]></Event>
<EventKey><![CDATA[EVENTKEY]]></EventKey>
</xml>

参数	描述
ToUserName	接收方微信号
FromUserName	发送方微信号，若为普通用户，则是一个OpenID
CreateTime	消息创建时间
MsgType	消息类型，event
Event	事件类型，subscribe(订阅)、unsubscribe(取消订阅)、CLICK(自定义菜单点击事件)
EventKey	事件KEY值，与自定义菜单接口中KEY值对应

消息回复

对于每一个POST请求，开发者在响应包中返回特定xml结构，对该消息进行响应（现支持回复文本、图文、语音、视频、音乐）。

微信服务器在五秒内收不到响应会断掉连接。

回复xml结构如下：

回复文本消息

 <xml>
 <ToUserName><![CDATA[toUser]]></ToUserName>
 <FromUserName><![CDATA[fromUser]]></FromUserName>
 <CreateTime>12345678</CreateTime>
 <MsgType><![CDATA[text]]></MsgType>
 <Content><![CDATA[content]]></Content>
 </xml>

参数	描述
ToUserName	接收方帐号（收到的OpenID）
FromUserName	开发者微信号
CreateTime	消息创建时间
MsgType	text
Content	回复的消息内容,长度不超过2048字节

回复音乐消息

 <xml>
 <ToUserName><![CDATA[toUser]]></ToUserName>
 <FromUserName><![CDATA[fromUser]]></FromUserName>
 <CreateTime>12345678</CreateTime>
 <MsgType><![CDATA[music]]></MsgType>
 <Music>
 <Title><![CDATA[TITLE]]></Title>
 <Description><![CDATA[DESCRIPTION]]></Description>
 <MusicUrl><![CDATA[MUSIC_Url]]></MusicUrl>
 <HQMusicUrl><![CDATA[HQ_MUSIC_Url]]></HQMusicUrl>
 </Music>
 </xml>

参数	描述
ToUserName	接收方帐号（收到的OpenID）
FromUserName	开发者微信号
CreateTime	消息创建时间
MsgType	music
MusicUrl	音乐链接
HQMusicUrl	高质量音乐链接，WIFI环境优先使用该链接播放音乐

回复图文消息

 <xml>
 <ToUserName><![CDATA[toUser]]></ToUserName>
 <FromUserName><![CDATA[fromUser]]></FromUserName>
 <CreateTime>12345678</CreateTime>
 <MsgType><![CDATA[news]]></MsgType>
 <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>
 </xml>

参数	描述
ToUserName	接收方帐号（收到的OpenID）
FromUserName	开发者微信号
CreateTime	消息创建时间
MsgType	news
ArticleCount	图文消息个数，限制为10条以内
Articles	多条图文消息信息，默认第一个item为大图
Title	图文消息标题
Description	图文消息描述
PicUrl	图片链接，支持JPG、PNG格式，较好的效果为大图640*320，小图80*80。
Url	点击图文消息跳转链接

官方接口文档：

http://mp.weixin.qq.com/wiki/index.php?title=%E6%B6%88%E6%81%AF%E6%8E%A5%E5%8F%A3%E6%8C%87%E5%8D%97

注意事项

1.用户OpenID对一个公众号是固定唯一的串

2.请使用80端口

尽请关注：后续我们将全面讲解具体的开发过程。

三、消息类图

 

更多微信公眾平台開發基本原則及訊息接相关文章请关注PHP中文网！