接口在线调试

为了方便微信开发者熟悉各个接口的调用，微信团队推出了微信公众平台接口在线调试工具，输入网址 https://www.wechatadd.com/，出现的界面如图 2-15 所示。

图 2-15　微信公众平台接口在线调试工具界面

该工具会根据开发者选择的接口类型（比如基础支持、向用户发送消息、用户管理、自定义菜单等九大接口）自动生成相应接口的参数列表，开发者只需填写对应的参数值并单击「检查问题」按钮就会得到相应的调试信息。比如选择接口类型为基础支持，接口列表的下拉列表中的选项显示为获取 access_token 接口/token、多媒体文件上传接口/media/upload、下载多媒体文件接口/media/get、上传 logo 接口/media/uploading。而参数列表将会根据选择的接口类型而显示相应的参数。

微信公众平台中的基础支持接口包括获取 access_token 和获取微信服务器 IP 地址。不管公众平台是哪种类型的账号，都支持这两种基础支持接口，获得基础接口也无须账号认证。

access_token 是公众号的全局唯一接口调用凭据。公众号调用各接口时都需使用 access_token，需要进行妥善保存。access_token 的存储至少要保留 512 个字符空间。access_token 的有效期目前为 2h，也就是 7200s，因此需要定时刷新，而重复获取将导致上次获取的 access_token 失效。

1. access_token 的使用

（1）为了对 appsecret 进行保密，开发者或运营商需要一个获取和刷新 access_token 的中控服务器。而其他业务逻辑服务器所使用的 access_token 均来自于该中控服务器，不能各自去刷新，否则会造成 access_token 覆盖而影响业务。

（2）access_token 的有效期通过返回的 expire_in 来传达，目前是 7200s 以内的值。中控服务器需要根据这个有效时间提前去刷新 access_token。在刷新过程中，中控服务器对外输出的依然是旧的 access_token。此时公众平台后台会保证在刷新时的短时间内，新旧 access_token 都可使用，这可以保证第三方业务的平滑过渡。

（3）access_token 的有效时间可能在未来会有调整，所以中控服务器不仅需要内部定时主动刷新，还需要提供被动刷新 access_token 的接口，这样便于业务服务器在 API 调用获知 access_token 已超时的情况下，可以触发 access_token 的刷新流程。

2. access_token 的生成

公众号可以使用 AppID 和 AppSecret 调用接口来获取 access_token。AppID 和 AppSecret 可在微信公众平台官网-开发页中获得（需要已经成为开发者，且账号没有异常状态），如图 2-16 所示。注意，调用所有微信接口时均需使用 HTTPS 协议。如果开发者或运营商不使用中控服务器，而是选择业务逻辑点各自去刷新 access_token，就可能会产生冲突，导致服务不稳定。

图 2-16　开发者配置

HTTP 请求方式：GET。

https://www.wechatadd.com;appid=APPID&secret=APPSECRET

参数说明如表 2-2 所示。

表 2-2　获取 access_token 参数说明

正常情况下，微信会返回下述 JSON 数据包给公众号。

JSON 数据包参数说明如表 2-3 所示。

表 2-3　获取 access_token 返回 JSON 数据包参数说明

错误时，微信会返回错误码等信息，JSON 数据包示例如下（该示例为 AppID 无效错误）。