微信公众平台开发者文档精编版

最新资料推荐微信公众平台开发者文档注：本人引用微信公众平台开发者文档只为方便，一切版权归微信公众平台所有。目录一、新手指南91、接入指南9目录9概述9第一步：填写服务器配置9第二步：验证服务器地址的有效性11第三步：依据接口文档实现业务逻辑122、典型案例介绍12招商银行信用卡中心13中国南方航空14广东联通153、开发者规范154、模板消息运营规范165、公众号类型的接口权限说明186、微信开发者互助问答系统20二、测试号申请|在线调试211、接口调试工具212、接口测试号申请21三、报警排查|返回码211、接口频率限制说明212、全局接口返回码说明233、报警排查指引28目录28概要说明28报警内容说明30各类报警的排查方法31常见问题32附录34附录1：微信推送的消息事件列表和响应格式34附录2：查看服务器性能负载的常用工具34附录3：nginx配置和排查指引354、微信推送消息与事件说明36四、消息加解密|消息签名371、方案概述372、接入指引39目录39函数说明39使用方法40注意事项42函数错误返回码42示例代码下载43微信公众平台接口调试工具433、技术方案43阅读须知43公众账号接收用户消息44公众账号向用户回复消息464、开发者FAQ47消息加解密功能开发者FAQ47五、基础接口491、获取access_token492、获取微信服务器IP地址51六、接收消息521、验证消息真实性522、接收普通消息53目录53文本消息53图片消息54语音消息55视频消息55小视频消息56地理位置消息57链接消息583、接收事件推送59目录59关注/取消关注事件59扫描带参数二维码事件60上报地理位置事件61自定义菜单事件62点击菜单拉取消息时的事件推送62点击菜单跳转链接时的事件推送634、接收语音识别结果64七、发送消息651、发送被动回复消息65目录66回复文本消息66回复图片消息66回复语音消息67回复视频消息67回复音乐消息68回复图文消息692、客服接口70目录71客服帐号管理71客服接口-发消息753、高级群发接口79目录79上传图文消息素材【订阅号与服务号认证后均可用】79根据分组进行群发【订阅号与服务号认证后均可用】81根据OpenID列表群发【订阅号不可用，服务号认证后可用】85删除群发【订阅号与服务号认证后均可用】89预览接口【订阅号与服务号认证后均可用】90查询群发消息发送状态【订阅号与服务号认证后均可用】92事件推送群发结果934、模板消息接口95目录95设置所属行业95获得模板ID98发送模板消息98事件推送1025、获取自动回复规则104八、素材管理1091、新增临时素材1092、获取临时素材1113、新增永久素材112新增永久图文素材112新增其他类型永久素材1134、获取永久素材1155、删除永久素材1176、修改永久图文素材1187、获取素材总数1208、获取素材列表121九、用户管理1241、用户分组管理124目录124创建分组124查询所有分组125查询用户所在分组127修改分组名127移动用户分组128批量移动用户分组129删除分组1302、设置用户备注名131设置备注名1313、获取用户基本信息(UnionID机制)132获取用户基本信息（包括UnionID机制）1324、获取用户列表1345、获取用户地理位置136获取用户地理位置1376、网页授权获取用户基本信息137目录139第一步：用户同意授权，获取code139第二步：通过code换取网页授权access_token141第三步：刷新access_token（如果需要）142第四步：拉取用户信息(需scope为 snsapi_userinfo)143附：检验授权凭证（access_token）是否有效145十、自定义菜单管理1461、自定义菜单创建接口1462、自定义菜单查询接口1513、自定义菜单删除接口1514、自定义菜单事件推送152目录152点击菜单拉取消息时的事件推送152点击菜单跳转链接时的事件推送153scancode_push：扫码推事件的事件推送153scancode_waitmsg：扫码推事件且弹出“消息接收中”提示框的事件推送154pic_sysphoto：弹出系统拍照发图的事件推送155pic_photo_or_album：弹出拍照或者相册发图的事件推送156pic_weixin：弹出微信相册发图器的事件推送157location_select：弹出地理位置选择器的事件推送1585、获取自定义菜单配置接口159十一、帐号管理1631、生成带参数的二维码163创建二维码ticket164通过ticket换取二维码1662、长链接转短链接接口166接口调用请求说明166十二、数据统计接口1681、用户分析数据接口1682、图文分析数据接口1703、消息分析数据接口1774、接口分析数据接口182十三、微信JS-SDK1851、微信JS-SDK说明文档185目录186概述187基础接口190分享接口190图像接口192音频接口193智能接口195设备信息195地理位置196界面操作196微信扫一扫197微信小店198微信卡券198微信支付200附录1-JS-SDK使用权限签名算法201附录2-所有JS接口列表202附录3-所有菜单项列表203附录4-卡券扩展字段及签名生成算法204附录5-常见错误及解决方法205附录6-DEMO页面和示例代码208附录7-问题反馈208十四、微信小店接口2091、微信小店接口209十五、微信卡劵接口2101、微信卡劵接口说明210目录210卡券接口概述210卡券资料包下载2112、创建卡劵212目录212创建卡券2123、会员卡、特殊票劵224目录224会员卡224特殊票类235景区门票237电影票237会议门票240飞机票240汽车票2424、投放卡劵245目录245创建二维码接口245添加卡券JS-SDK247群发卡券247投放渠道数据统计2495、核销卡劵250目录250核销Code接口250线上核销接口252拉取卡券列表接口252Code解码接口2526、管理卡劵254目录254查询code254查看卡券详情255批量查询卡列表260更改卡券信息接口261修改库存接口265更改Code接口266删除卡券接口268设置卡券失效接口2697、卡卷事件推送270目录270卡券事件推送2708、卡劵错误码275十六、微信智能接口2761、语义理解接口276十七、设备功能介绍2791、设备功能介绍279目录279服务号设备功能介绍279十八、多客服功能2811、将消息转发到多客服2812、客服管理283目录2833、多客服会话控制290目录2904、获取客服聊天记录296获取客服聊天记录接口2965、PC客户端自定义插件接口298目录298PC客户端自定义页面插件接口298十九、摇一摇周边3061、设备管理306目录306申请设备ID306编辑设备信息308配置设备与门店的关联关系309查询设备列表3102、页面管理313目录313新增页面313编辑页面信息314查询页面列表315删除页面3173、素材管理318上传图片素材3184、配置设备与页面的关联关系319配置设备与页面的关联关系3195、获取设备及用户信息320获取摇周边的设备及用户信息3206、数据统计322以设备为维度的数据统计接口322以页面为维度的数据统计接口3247、摇一摇关注JSAPI325摇一摇关注JS API325一、 新手指南1、 接入指南目录 1概述 2第一步：填写服务器配置 3第二步：验证服务器地址的有效性 4第三步：依据接口文档实现业务逻辑概述接入微信公众平台开发，开发者需要按照如下步骤完成：1、填写服务器配置2、验证服务器地址的有效性3、依据接口文档实现业务逻辑下面详细介绍这3个步骤。第一步：填写服务器配置登录微信公众平台官网后，在公众平台后台管理页面 - 开发者中心页，点击“修改配置”按钮，填写服务器地址（URL）、Token和EncodingAESKey，其中URL是开发者用来接收微信消息和事件的接口URL。Token可由开发者可以任意填写，用作生成签名（该Token会和接口URL中包含的Token进行比对，从而验证安全性）。EncodingAESKey由开发者手动填写或随机生成，将用作消息体加解密密钥。同时，开发者可选择消息加解密方式：明文模式、兼容模式和安全模式。模式的选择与服务器配置在提交后都会立即生效，请开发者谨慎填写及选择。加解密方式的默认状态为明文模式，选择兼容模式和安全模式需要提前配置好相关加解密代码，详情请参考消息体签名及加解密部分的文档。第二步：验证服务器地址的有效性开发者提交信息后，微信服务器将发送GET请求到填写的服务器地址URL上，GET请求携带四个参数：参数描述signature微信加密签名，signature结合了开发者填写的token参数和请求中的timestamp参数、nonce参数。timestamp时间戳nonce随机数echostr随机字符串开发者通过检验signature对请求进行校验（下面有校验方式）。若确认此次GET请求来自微信服务器，请原样返回echostr参数内容，则接入生效，成为开发者成功，否则接入失败。加密/校验流程如下：1. 将token、timestamp、nonce三个参数进行字典序排序2. 将三个参数字符串拼接成一个字符串进行sha1加密3. 开发者获得加密后的字符串可与signature对比，标识该请求来源于微信检验signature的PHP示例代码：