微信接入探秘（一）——从零认识微信接口

本文出处：http://blog.csdn.net/chaijunkun/article/details/53385088，转载请注明。由于本人不定期会整理相关博文，会对相应内容作出完善。因此强烈建议在原始出处查看此文

写在前面

回想起来今年还没有在CSDN上发过文章，草稿箱里积攒了很多话题，可由于时间关系最终也没发出来。不能再拖了，打算写个系列专题，聊聊微信接入。

随着微信用户量的不断增加，越来越多的企业也将自己的服务加入到了微信当中。微信本身提供的公众号、服务号的基础功能难以满足日趋增长的需求，于是微信为我们打开了一整套自定义功能的API，利用这些API，我们可以弥补原有平台的不足，创造出更加方便的功能。本篇先对微信接口进行简单的介绍。

腾讯虽然官方也提供了很多语言版本的开发包（参阅：http://qydev.weixin.qq.com/wiki/index.php?title=加解密库下载与返回码），包括C++、Python、php、java和C#，但是笔者发现作为以PHP为主导技术的公司，Java版本的SDK无论是从封装性能、可维护性还是语法结构上都不够严谨。也正是因此才有了做一套开源API适配库的想法，目的就是为了让微信接入更简单、更容易维护（项目地址为：https://code.csdn.net/chaijunkun/wechat-common）

任何新技术的掌握都是从文档开始的，如果你刚刚接触微信接入开发，不妨先看看官方的文档：https://mp.weixin.qq.com/wiki（这个地址后来发现有点问题，可能是启用了refer屏蔽，从博客跳转过去会报错，随便点个报错页面的链接，粘贴地址后即可访问）

通过阅读文档，我们大概将微信接口分为两类：被动回调（集中在文档的消息管理部分）接口和主动调用接口。

被动回调接口

严格意义上来说，该接口的业务逻辑是由我们自定义的。当有相应的事件发生时，微信会按照之前配置好的公众平台参数主动请求你的接口。请求参数和请求体都是在文档中明确声明的，我们要做的就是对其进行适配。

该接口的作用类似于短信中心。当用户订阅了你的公众号之后可以向其主动发送信息，但消息不是直接到达了你的后台系统，而是通过微信的转发回调机制，将内容通过统一的格式发送给接入的后台系统。你是否还记得有些电视节目中参与互动，发特定的短信内容到一个服务号码上就能参与进去？道理是一样的。

若需要使用回调接口，需要在正式使用前对账号进行配置。方法为：登录微信公众号平台. 登录地址:https://mp.weixin.qq.com/，查看自己的公众号。

a.若使用正式公众号调试，请在左侧菜单中找到”开发”->”基本配置”->”开发者ID”和”服务器配置”中找到对应的配置项。

b.若使用公众号的测试账号调试，请在左侧菜单中找到”开发”->”开发者工具”->”公众平台测试帐号”->”进入”->扫描登录二维码->”测试号信息”和”接口配置信息”中找到对应的配置项。

一个通常的业务模式为下图所示

Created with Raphaël 2.1.0 用户 用户 微信 微信 公众号后台 公众号后台 主动发送消息 读取公众号配置 格式化消息,通过回调通知后台 同步等待返回数据 读取消息来源（用户id） 分析消息，实现自定义业务逻辑 返回特定格式的应答字符串 接收到返回数据 验证消息的格式正确性 将内容转发给用户客户端

上述场景中，公众号处于被动模式，只有用户主动发送消息，才会触发微信回调公众号后台，并产生相应的应答。实际应用场景有：“回复XX给你看一张图”，“给我们的节目留言”等等。

关于该处的配置和调试方法将会在后续章节中详细介绍

主动调用接口

刚刚我们说过用户主动向公众号发送消息，那么有没有主动发消息给用户的场景呢？例如：告警系统，机房中哪台机器出现问题我们事先是不知道的，监测到异常时需要主动发消息通知用户。那么就涉及到了主动调用类接口了。这部分接口包罗万象，是微信接口的重点和难点。

微信官方针对主动调用的接口进行了一些列限制，例如公众号不能给未关注该号的用户发送消息（旨在保护用户不被恶意打扰），例如API访问令牌Token，每天的获取次数也根据公众号的类型做了不同的限制。

一个通常的业务模式为下图所示

Created with Raphaël 2.1.0 用户 用户 微信 微信 公众号后台 公众号后台 关注公众号 读取公众号配置 格式化消息,通过回调发送"用户关注"事件 读取消息来源,将用户id持久化到DB 需要主动发送消息给用户时，读取用户信息 获取访问令牌 返回访问令牌 拿到Token Token+用户id+格式化的消息 主动调用微信接口 验证消息的格式正确性、合法性 将内容转发给用户客户端

具体实践，后续章节中也会对其进行介绍。

本节对微信接口进行了分类和原理的粗略解释，更多内容请关注我的博客，也欢迎针对该开源框架提出改进性建议。