天天看點

微信公衆平台消息接口API指南

微信公衆平台消息接口為開發者提供了一種新的消息處理方式。微信公衆平台消息接口為開發者提供與使用者進行消息互動的能力。對于成功接入消息接口的微信公衆賬号,當使用者發消息給公衆号,微信公衆平台伺服器會使用http請求對接入的網址進行消息推送,第三方伺服器可通過響應包回複特定結構,進而達到回複消息的目的。

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

微信公衆平台消息接口API指南

公衆平台使用者送出資訊後,微信伺服器将發送GET請求到填寫的URL上,并且帶上四個參數:

參數

描述

signature

微信加密簽名

timestamp

時間戳

nonce

随機數

echostr

随機字元串

開發者通過檢驗signature對請求進行校驗(下面有校驗方式)。若确認此次GET請求來自微信伺服器,請原樣傳回echostr參數内容,則接入生效,否則接入失敗。

signature結合了開發者填寫的token參數和請求中的timestamp參數、nonce參數。

當普通微信使用者向公衆賬号發消息時,微信伺服器将POST該消息到填寫的URL上。結構如下:

ToUserName

開發者微信号

FromUserName

發送方帳号(一個OpenID)

CreateTime

消息建立時間 (整型)

MsgType

text

Content

文本消息内容

MsgId

消息id,64位整型

image

PicUrl

圖檔連結

location

Location_X

地理位置次元

Location_Y

地理位置經度

Scale

地圖縮放大小

Label

地理位置資訊

接收方微信号

發送方微信号,若為普通使用者,則是一個OpenID

消息建立時間

消息類型,link

Title

消息标題

Description

消息描述

Url

消息連結

事件推送隻支援微信4.5版本,即将開放,敬請期待。

消息類型,event

Event

事件類型,有ENTER(進入會話)和LOCATION(地理位置)

Latitude

地理位置次元,事件類型為LOCATION的時存在

Longitude

地理位置經度,事件類型為LOCATION的時存在

Precision

地理位置精度,事件類型為LOCATION的時存在

對于每一個POST請求,開發者在響應包中傳回特定xml結構,對該消息進行響應(現支援回複文本、圖文、語音、視訊、音樂和對收到的消息進行星标操作)。

微信伺服器在五秒内收不到響應會斷掉連接配接。

回複xml結構如下:

接收方帳号(收到的OpenID)

回複的消息内容

FuncFlag

位0x0001被标志時,星标剛收到的消息。

music

MusicUrl

音樂連結

HQMusicUrl

高品質音樂連結,WIFI環境優先使用該連結播放音樂

news

ArticleCount

圖文消息個數,限制為10條以内

Articles

多條圖文消息資訊,預設第一個item為大圖

圖文消息标題

圖文消息描述

圖檔連結,支援JPG、PNG格式,較好的效果為大圖640*320,小圖80*80,限制圖檔連結的域名需要與開發者填寫的基本資料中的Url一緻

點選圖文消息跳轉連結

1.使用者OpenID對一個公衆号是固定唯一的串

2.請使用80端口

3.使用者關注公衆号,微信公衆平台伺服器推送一條内容為Hello2BizUser的文本消息到第三方伺服器

微信公衆平台消息接口API指南
微信公衆平台消息接口API指南

 原文:http://www.cnblogs.com/txw1958/p/wechat-tutorial.html 

繼續閱讀