使用公众平台接口进行开发

1、使用公众平台接口进行开发查看文档使用公众平台的开发接口，公众号可在自身服务器上接收用户的微信消息，并可按需回复。止匕外，我们还提供了更多更高级的功能和体验，如会话界面的自定义菜单、获取更多类型的消息等。消息接口指南返回出自开放平台跳转到：,搜索目录*1简介,2申请消息接口,3网址接入,4消息推送o4.1文本消息o4.2图片消息o4.3地理位置消息o4.4链接消息o4.5事件推送5消息回复o 5.1回复文本消息o 5.2回复音乐消息o 5.3回复图文消息* 6注意事项* 7示例代码简介公众平台消息接口为开发者提供了一种新的消息处理方式申请消息接口点击史埴，填写网址url和token,其中toke

2、n可由开发者可以任意填写，用作生成签名。高皴功能>开发模式>成为开发者成为开发者后r你才可以使用公众平台的开发功直纪需要填写URL和Tdken.这两项信息需要专拥有自己的接口配置信意URL输入URL|必须以头r目前只支持80Token"一：必石小音由左。33一'Hir,eaHBmaBlZ-VVVkjl-jJTj77J1"J什么是Token?提交网址接入公众平台用户提交信息后，微信服务器将发送GET青求到填写的URL±,并且带上四个参数：参数描述signature微信加密签名timestamp时间戳nonce随机数echostr随机字符串开发者通

3、过检验signature对请求进行校验（下面有校验方式）。若确认此次GET青求来自微信服务器，请原样返回echostr参数内容，则接入生效，否则接入失败。signature结合了开发者填写的token参数和请求中的timestamp参数、nonce参数。加密/校验流程：1 .将token、timestamp、nonce三个参数进行字典序排序2 .将三个参数字符串拼接成一个字符串进行sha1加密3 .开发者获得加密后的字符串可与signature对比，标识该请求来源于微信消息推送当普通微信用户向公众账号发消息时，微信服务器将POST或消息到填写的URL上。结构如下：文本消息<xml>

4、<ToUserName><!CDATAtoUser></ToUserName><FromUserName><!CDATAfromUser></FromUserName><CreateTime>1348831860</CreateTime><MsgType><!CDATAtext></MsgType><Content><!CDATAthisisatest></Content><MsgId>123456789012345

5、6</MsgId></xml>参数描述ToUserName开发者微信号FromUserName发送方帐号（一个OpenID）CreateTime消息创建时间（整型）MsgTypetextContent文本消息内容MsgId消息id,64位整型图片消息<xml><ToUserName><!CDATAtoUser></ToUserName><FromUserName><!CDATAfromUser></FromUserName><CreateTime>1348831860<

6、/CreateTime><MsgType><!CDATAimage></MsgType><PicUrl><!CDATAthisisaurl></PicUrl><MsgId>1234567890123456</MsgId></xml>参数描述ToUserName开发者微信号FromUserName发送方帐号（一个OpenID）CreateTime消息创建时间（整型）MsgTypeimagePicUrl图片链接MsgId消息id,64位整型地理位置消息<xml><To

7、UserName><!CDATAtoUser></ToUserName><FromUserName><!CDATAfromUser></FromUserName><CreateTime>1351776360</CreateTime><MsgType><!CDATAlocation></MsgType><Location_X>23.134521</Location_X><Location_Y>113.358803</Locatio

8、n_Y><Scale>20</Scale><Label><!CDATA位置信息></Label><MsgId>1234567890123456</MsgId></xml>参数描述ToUserName开发者微信号FromUserName发送方帐号（一个OpenID）CreateTime消息创建时间（整型）MsgTypelocationLocation_X地理位置纬度Location_Y地理位置经度Scale地图缩放大小Label地理位置信息MsgId消息id,64位整型链接消息<xml&g

9、t;<ToUserName><!CDATAtoUser></ToUserName><FromUserName><!CDATAfromUser></FromUserName><CreateTime>1351776360</CreateTime><MsgType><!CDATAlink></MsgType><Title><!CDATA公众平台官网链接></Title><Description><!CDATA公众平台

10、官网链接></Description><Url><!CDATAurl></Url><MsgId>1234567890123456</MsgId></xml>参数描述ToUserName接收方微信号FromUserName发送方微信号，若为普通用户，则是一个OpenIDCreateTime消息创建时间MsgType消息类型,linkTitle消息标题Description消息描述Url消息链接MsgId消息id,64位整型事件推送事件推送只支持微信4.5版本，目前开启自定义菜单接口事件推送、关注与取消关注事

11、件推送。其余功能即将开放，敬请期待。<xml><ToUserName><!CDATAtoUser></ToUserName><FromUserName><!CDATAFromUser></FromUserName><CreateTime>123456789</CreateTime><MsgType><!CDATAevent></MsgType><Event><!CDATAEVENT></Event><Event

12、Key><!CDATAEVENTKEY></EventKey></xml>参数描述ToUserName接收方微信号FromUserName发送方微信号，若为普通用户，则是一个OpenIDCreateTimeMsgType消息创建时间消息类型，eventEvent事件类型，subscribe（订阅）、unsubscribe（取消订阅）、CLICK（自定义菜单点击事件）EventKey事件KEY®,与自定义菜单接口中KEY®对应消息回复对于每一个POST青求，开发者在响应包中返回特定xml结构，对该消息进行响应（现支持回复文本、图文、语

13、音、视频、音乐和对收到的消息进行星标操作）微信服务器在五秒内收不到响应会断掉连接。回复xml结构如下：回复文本消息<xml><ToUserName><!CDATAtoUser></ToUserName><FromUserName><!CDATAfromUser></FromUserName><CreateTime>12345678</CreateTime><MsgType><!CDATAtext></MsgType><Content><

14、;!CDATAcontent></Content><FuncFlag>0</FuncFlag></xml>参数描述ToUserName接收方帐号（收到的OpenID）FromUserName开发者微信号CreateTime消息创建时间MsgTypetextContent回复的消息内容，长度不超过2048字节FuncFlag位0x0001被标志时，星标刚收到的消息。回复音乐消息<xml><ToUserName><!CDATAtoUser></ToUserName><FromUserName

15、><!CDATAfromUser></FromUserName><CreateTime>12345678</CreateTime><MsgType><!CDATAmusic></MsgType><Music><Title><!CDATATITLE></Title><Description><!CDATADESCRIPTION></Description><MusicUrl><!CDATAMUSIC_Url

16、></MusicUrl><HQMusicUrl><!CDATAHQ_MUSIC_Url></HQMusicUrl></Music><FuncFlag>0</FuncFlag></xml>参数描述ToUserName接收方帐号（收到的OpenID）FromUserName开发者微信号CreateTime消息创建时间MsgTypemusicMusicUrl音乐链接HQMusicUrl高质量音乐链接，WIFI环境优先使用该链接播放音乐FuncFlag位0x0001被标志时，星标刚收到的消息。回复图文

17、消息<xml><ToUserName><!CDATAtoUser></ToUserName><FromUserName><!CDATAfromUser></FromUserName><CreateTime>12345678</CreateTime><MsgType><!CDATAnews></MsgType><ArticleCount>2</ArticleCount><Articles><item><

18、;Title><!CDATAtitle1></Title><Description><!CDATAdescription1></Description><PicUrl><!CDATApicurl></PicUrl><Url><!CDATAurl></Url></item><item><Title><!CDATAtitle></Title><Description><!CDATAde

19、scription></Description><PicUrl><!CDATApicurl></PicUrl><Url><!CDATAurl></Url></item></Articles><FuncFlag>1</FuncFlag></xml>参数描述ToUserName接收方帐号（收到的OpenID）FromUserName开发者微信号CreateTime消息创建时间MsgTypenewsiArticleCount图文消息个数，限制为10条以

20、内Articles多条图文消息信息，默认第一个item为大图Title图文消息标题Description图文消息描述PicUrl图片链接，支持JPGPNG&式，较好的效果为大图640*320,小图80*80oUrl点击图文消息跳转链接注意事项1 .用户OpenID对一个公众一号是固定唯一的用2 .请使用80端口示例代码通用接口文档返回出自开放平台跳转到：,搜女简介通用接口是使用HTTP青求，让开发者直接与微信服务器交互，实现媒体文件上传、媒体文件获取等功能，达到获取图片、语音、视频等媒体文件的目的。调用接口所需要的access_token必须通过获取凭证接口获取。获取凭证接口说明在使用

21、通用接口前，你需要做以下两步工作：1 .拥有一个微信公众账号，并获取到appid和appsecret（在公众平台申请内测资格，审核通过后可获得）2 .通过获取凭证接口获取到access_token注意：access_token是第三方访问api资源的票据；access_token对应于公众号是全局唯一的票据，重复获取将导致上次获取的access_token失效。请求说明http请求方式:GEThttps:appid=APPID&secret=APPSECRET参数说明参数是否必须说明grant_type是获取access_token填写client_credentialappid是第二

22、方用户唯一凭证secret是第二方用户唯一凭证伤钥，既appsecret返回说明正确的Json返回结果："accesstoken':"ACCESS_TOKEN","expires_in":7200参数说明access_token获取到的凭证expires_in凭证后效时间，单位：秒错误的Json返回示例："errcode”:40013,"errmsg":"invalidappid"统一返回码说明自定义菜单接口返回出自开放平台跳转到：导近，搜室目录SB 1简介 2菜单创建 3菜单查询 4菜

23、单删除简介开发者获取使用凭证（如何获取凭证）后，可以使用该凭证对公众账号的自定义菜单进行创建、查询和删除等操作。自定义菜单接口可实现以下类型按钮：click（点击事件）：用户点击click类型按钮后，微信服务器会通过消息接口（event类型）推送点击事件给开发者，并且带上按钮中开发者填写的key值，开发者可以通过自定义的key值进行消息回复。创建自定义菜单后，由于微信客户端缓存，需要24小时微信客户端才会展现出来。建议测试时可以尝试取消关注公众账号后，再次关注，则可以看到创建后的效果。菜单创建接口说明通过POSK个特定结构体，实现在微信客户端创建自定义菜单。请求说明http请求方式：POSTh

24、ttps:请求示例"button":"type":"click","name":"今日歌曲"，"key":"V1001_TODAY_MUSIC","type":"click","name":"歌手简介","key":"V1001_TODAY_SINGER","name":"菜单"，"sub

25、_button":."type":"click","name":"helloword","key":"V1001_HELLO_WORLD""type":"click","name":"赞一下我们”,"key":"V1001_GOOD"创建后效果：参数说明参数是否必须说明button是按钮数组，按钮个数应为23个sub_button否子按钮数组，按钮个数应为2

26、5个type是按钮类型，目前由click类型name是按钮描述，既按钮名字，不超过16个字节，子菜单不超过40个字节key英型为click必须按钮KEY®,用于消息接口（event类型）推送，不超过128字节返回说明正确的Json返回结果："errcode":0,"errmsg":"ok"错误的Json返回结果"errcode":40018,"errmsg":"invalidbuttonnamesize"统一返回码说明菜单查询接口说明查询当前使用的自定义菜单结构。请

27、求说明http请求方式：GEThttps:返回说明对应创建接口，正确的Json返回结果："menu":"button":"type":"click","name":"今日歌曲","key":"V1001_TODAY_MUSIC","sub_button":口,"type":"click","name":"歌手简介","key":"V1001_TODAY_SINGER","sub_button":口,"name":"菜单","sub_b