微信公众平台消息接口API指南9P

1、W微信公众轻激口 API指南简介微信公众平台消息接口为开发者提供了一种新的消息处理方式。微信公众平台消息接口为开发者提供与用户进行消息交互的能力。对于成功接入消息接口的微 信公众账号，当用户发消息给公众号，微信公众平台服务器会使用http请求对接入的网址进行消息推送，第三方服务器可通过响应包回复特定结构， 从而达到 回复消息的目的。申请消息接口点击申请，填写网址url和token，其中token可由开发者可以任意填写，用作 生成签名。高级功能 > 开发復式 > 成为开发者成为开发者后f你才可殴便用公处平台的开着功尬 需要填写URL和Token r这两项信息需要吩掏有自己的接口配青信

2、息佇么是Token?网址接入公众平台用户提交信息后，微信服务器将发送GET青求到填写的URL上,并且带 上四个参数：参数描述sig nature微信加密签名timestamp时间戳nonce随机数echostr随机字符串开发者通过检验sig nature对请求进行校验（下面有校验方式）。若确认此次 GET青求来自微信服务器，请原样返回 echostr参数内容，则接入生效，否则接 入失败。sig nature 结合了开发者填写的toke n参数和请求中的timestamp参数、nonce 参数。加密/校验流程：1.将token、timestamp、nonce三个参数进行字典序排序2将三个参数字符

3、串拼接成一个字符串进行sha1加密3.开发者获得加密后的字符串可与 sig nature对比，标识该请求来源于微信消息推送当普通微信用户向公众账号发消息时，微信服务器将POST亥消息到填写的URL上。结构如下：文本消息<xml><ToUserNamex!CDATAtoUserx/ToUserName> <FromUserName><!CDATAfromUserx/FromUserName> <CreateTime>1348831860</CreateTime><MsgType><!CDATAtextx/M

4、sgType></xml>参数描述1ToUserName开发者微信号FromUserNamee发送方帐号（一个 OpenID）CreateTime消息创建时间（整型）1MsgTypetextContent文本消息内容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>参数描述ToUserName开发者微信号1FromUserNamee发送方帐号（一个 OpenID）CreateTime消息创建时间（整型）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>参数描述ToUserName开

7、发者微信号1FromUserNamee发送方帐号（一个 OpenID）CreateTime消息创建时间（整型）rMsgTypelocatio n1Locati on_X地理位置维度Locati on_Y地理位置经度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公众平台官网链接>v/Title><Description><!CDATA公众平台官网链接></Description><Url>v!CDATAurlx/Url></xml>参数描述ToUserName接收方微信号FromUserNamc?发送方微信号，若为普通用户，则是一个Ope nIDCreateTime消息创建时间MsgType消息类型，linkTitle消息标题

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>参数描述ToUserName接收方微信号FromUserName?发送方微信号，若为普通用户，则是一个Ope nIDCreateTime消息创建时间MsgType消息类型，eve ntEve nt事件类型，有ENTER进入会话）和LOCATION地理位置）Latitude地理位

11、置维度，事件类型为 LOCATIONS时存在Lon gitude地理位置经度，事件类型为 LOCATIONS时存在Precisio n地理位置精度，事件类型为 LOCATIONS时存在消息回复对于每一个POST青求，开发者在响应包中返回特定 xml结构，对该消息进行响 应（现支持回复文本、图文、语音、视频、音乐和对收到的消息进行星标操作）。微信服务器在五秒内收不到响应会断掉连接回复xml结构如下：回复文本消息<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>参数描述ToUserName接收方帐号（收到的OpenID）FromUserName夕开发者微信号CreateTime消息创建时间MsgTypetextContent回复的消息内容Fu

13、n cFlag位0x0001被标志时，星标刚收到的消息。回复音乐消息<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>参数描述ToUserName接收方帐号（收到的OpenID）FromUserName?开发者微信号CreateTime消息创建时间MsgTypemusicMu

15、sicUrl音乐链接HQMusicUrl高质量音乐链接，WIFI环境优先使用该链接播放音乐Fun cFlag位0x0001被标志时，星标刚收到的消息。回复图文消息<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>参数描述ToUserName接收方帐号（收到的Ope nID）FromUserName夕开发者微信号CreateTime消息创建时间MsgTypen ewsArtic