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

使用公众平台接口进行开发查看文档 使用公众平台的开发接口，公众号可在自身服务器上接收用户的微信消息，并可 按需回复。此外，我们还提供了更多更高级的功能和体验，如会话界面的自定义 菜单、获取更多类型的消息等。消息接口指南返回出自开放平台跳转到：导航，搜索目录隐藏. 1简介, 2申请消息接口3网址接入4消息推送ooooo4.1文本消息4.2图片消息4.3地理位置消息4.4链接消息4.5事件推送5消息回复o 5.1回复文本消息o 5.2回复音乐消息、o 5.3回复图文消息6注意事项 7示例代码简介公众平台消息接口为开发者提供了一种新的消息处理方式。申请消息接口点击申请，填写网址url和token，其中token可由开发者可以任意填写，用作 生成签名。网址接入公众平台用户提交信息后，微信服务器将发送GET请求到填写的URL上，并且带 上四个参数：参数描述signature微信加密签名timestamp时间戳nonce随机数echostr随机字符串 开发者通过检验signature对请求进行校验（下面有校验方式）。若确认此次 GET请求来自微信服务器，请原样返回echostr参数内容，则接入生效，否则接 入失败。signature结合了开发者填写的token参数和请求中的timestamp参数、nonce 参数。加密/校验流程：1. 将token、timestamp、nonce三个参数进行字典序排序2. 将三个参数字符串拼接成一个字符串进行sha 1加密3. 开发者获得加密后的字符串可与signature对比，标识该请求来源于微信消息推送当普通微信用户向公众账号发消息时，微信服务器将POST该消息到填写的URL 上。结构如下：文本消息13488318601234567890123456参数描述ToUserName开发者微信号FromUserName发送方帐号（个OpenID）CreateTime消息创建时间（整型）MsgTypetextContent文本消息内容MsgId消息id，64位整型图片消息13488318601234567890123456参数描述ToUserName开发者微信号FromUserName发送方帐号（个OpenID）CreateTime消息创建时间（整型）MsgTypeimagePicUrl图片链接MsgId消息id，64位整型地理位置消息135177636023.134521113.358803201234567890123456参数描述ToUserName开发者微信号FromUserName发送方帐号（个OpenID）CreateTime消息创建时间（整型）MsgTypelocationLocation_X地理位置纬度Location_Y地理位置经度Scale地图缩放大小Label地理位置信息MsgId消息id，64位整型链接消息13517763601234567890123456参数描述ToUserName接收方微信号FromUserName发送方微信号，若为普通用户，则是个OpenIDCreateTime消息创建时间MsgType消息类型，linkTitle消息标题Description消息描述Url消息链接MsgId消息id，64位整型事件推送事件推送只支持微信4.5版本，目前开启自定义菜单接口事件推送、关注与取消 关注事件推送。其余功能即将开放，敬请期待。123456789参数描述ToUserName接收方微信号FromUserName发送方微信号，若为普通用户，则是个OpenIDCreateTime消息创建时间MsgType消息类型，eventEvent事件类型，subscribe（订阅）、unsubscribe（取消订阅）、CLICK（自定义菜单点击事件）EventKey事件KEY值，与自定义菜单接口中KEY值对应消息回复对于每一个POST请求，开发者在响应包中返回特定xml结构，对该消息进行响 应（现支持回复文本、图文、语音、视频、音乐和对收到的消息进行星标操作）。微信服务器在五秒内收不到响应会断掉连接。回复xml结构如下：回复文本消息123456780参数描述ToUserName接收方帐号（收到的OpenID）FromUserName开发者微信号CreateTime消息创建时间MsgTypetextContent回复的消息内容，长度不超过2048字节FuncFlag位0x0001被标志时，星标刚收到的消息。回复音乐消息123456780参数描述ToUserName接收方帐号（收到的OpenID）FromUserName开发者微信号CreateTime消息创建时间MsgTypemusicMusicUrl音乐链接HQMusicUrl高质量音乐链接，WIFI环境优先使用该链接播放音乐FuncFlag位0x0001被标志时，星标刚收到的消息。回复图文消息1234567821参数描述ToUserName接收方帐号（收到的OpenID）FromUserName开发者微信号CreateTime消息创建时间MsgTypenewsArticleCount图文消息个数，限制为10条以内Articles多条图文消息信息，默认第一个item为大图Title图文消息标题Description图文消息描述PicUrl图片链接，支持JPG、PNG格式，较好的效果为大图 640*320，小图 80*80。Url点击图文消息跳转链接注意事项1. 用户OpenID对一个公众号是固定唯一的串2. 请使用80端口PHP：下载通用接口文档 返回出自开放平台跳转到：导航，搜索简介通用接口是使用HTTP请求，让开发者直接与微信服务器交互，实现媒体文件上 传、媒体文件获取等功能，达到获取图片、语音、视频等媒体文件的目的。调用接口所需要的access_token必须通过获取凭证接口获取。获取凭证接口说明在使用通用接口前，你需要做以下两步工作：1. 拥有一个微信公众账号，并获取到appid和appsecret（在公众平台申请内测 资格，审核通过后可获得）2. 通过获取凭证接口获取到access_token注意：access_token是第三方访问api资源的票据；access_token对应于公众号是全局唯一的票据，重复获取将导致上次获取的access_token 失效。请求说明http请求方式：GET type=client credential&appid二APPID&secret二APPSECRET参数说明参数是否必须说明grant_type是获取 access_token 填写 client_credentialappid是第三方用户唯一凭证secret是弟三方用户一凭证密钥，既appsecret返回说明正确的Json返回结果：access_token：ACCESS_TOKEN，expires_in：7200参数说明access_token获取到的凭证expires_in凭证有效时间，单位：秒错误的Json返回示例：errcode：40013,errmsg：invalid appid统一返回码说明自定义菜单接口返回出自开放平台跳转到：导航，搜索目录隐藏. 1简介. 2菜单创建.3菜单查询.4菜单删除简介开发者获取使用凭证（如何获取凭证）后，可以使用该凭证对公众账号的自定义 菜单进行创建、查询和删除等操作。自定义菜单接口可实现以下类型按钮：click （点击事件）：用户点击click类型按钮后，微信服务器会通过消息接口（event类型）推送点击 事件给开发者，并且带上按钮中开发者填写的key值，开发者可以通过自定义的 key值进行消息回复。创建自定义菜单后，由于微信客户端缓存，需要24小时微信客户端才会展现出 来。建议测试时可以尝试取消关注公众账号后，再次关注，则可以看到创建后的 效果。菜单创建接口说明通过POST 一个特定结构体，实现在微信客户端创建自定义菜单。请求说明http请求方式：POST token=ACCESS TOK EN请求示例(button：(type:click,name:今日歌曲，key:V1001_TODAY_MUSIC,(type:click,name:歌手简介，key:V1001_TODAY_SINGER,(name:菜单，sub_button:(工 - _匚_1type:click,name:hello word,key:V1001_HELLO_WORLD,(工 - _L_1type:click,name：赞一下我们,key：V1001_GOOD创建后效果:参数说明参数是否必须说明button是按钮数组，按钮个数应为23个sub_button否子按钮数组，按钮个数应为25个type是按钮类型，目前有click类型name是按钮描述，既按钮名字，不超过16个字节，子菜单不 超过40个字节key类型为click必须按钮KEY值，用于消息接口（event类型）推送，不超过 128字节返回说明正确的Json返回结果：errcode:0,errmsg:ok错误的Json返回结果errcode：40018,errmsg：invalid button name size统一返回码说明菜单查询接口说明查询当前使用的自定义菜单结构。请求说明http请求方式：GET token=ACCESS TOKEN返回说明对应创建接口，正确的Json返回结果：menu:button:type:click,name:今日歌曲,key:V1001_TODAY_MUSIC,sub_button:,type:click,name: 歌手简介,key:V1001_TODAY_SINGER,sub_button:,name:菜单 ,sub_button:type:click,name:helloword,key:V1001_HELLO_WORLD,sub_button:,type:click,nam e:赞一下我们，key:V1001_GOOD,sub_button:统一返回码说明菜单删除in接口说明取消当前使用的自定义菜单。请求说明http请求方式：GET token=ACCESS TOK EN返回说明对应创建接口，正确的Json返回结果：errcode:0,errmsg:ok统一返回码说明接口权限返回出自开放平台跳转到：导航，搜索简介请先确保公众账号已经拥有接口调用权限。默认每个公众帐号都不能超过下面的频率限制。当超出调用接口频率限制，调用对应接口将会收到如下错误信息：errcode：45009,errmsg：api freq out of limit接口调用频率限制接口名称频率限制获取凭证接口200 （次/天）自定义菜单创建接口100 （次/天）自定义菜单查询接口1000 （次/天）自定义菜单删除接口100 （次/天）接口权限返回出自开放平台跳转到：导航，搜索简介请先确保公众账号已经拥有接口调用权限。默认每个公众帐号都不能超过下面的频率限制。当超出调用接口频率限制，调用 对应接口将会收到如下错误信息：errcode：45009,errmsg：api freq out of limit接口调用频率限制接口名称频率限制获取凭证接口200 （次/天）自定义菜单创建接口100 （次/天）自定义菜单查询接口1000 （次/天）自定义菜单删除接口100 （次/天）