微信公众平台通用接口API指南

 

下述文档已过期，新版文档请访问 http://www.cnblogs.com/txw1958/p/weixin-access-token.html

 
微信公众平台目前分成消息接口和通用接口两大模块。

接入消息接口的微信公众账号，当关注该公众账号的粉丝向其发送消息，微信服务器会对公众账号所对应的服务器地址推送一个特定结构的消息体，公众账号开发者可以通过响应包进行对该条消息的回复。

通用接口的作用是实现诸如获取粉丝资料，上传媒体文件以便消息接口回复图片、语音和视频等多媒体消息等功能，丰富消息接口的同时支持主动推送消息给用户。

使用接口的任何一个公众账号都拥有唯一的Appid和Appsecret，对于该公众账号都有一个使用等级，使用等级高的将享有更高的接口调用频率。开发者应评估自己的应用，并对公众号等级进行相应的申请。

 

简介

微信公众平台通用接口是使用HTTP请求，让开发者直接与微信服务器交互，实现媒体文件上传、媒体文件获取等功能，达到获取图片、语音、视频等媒体文件的目的。

微信公众平台调用接口所需要的access_token必须通过获取凭证接口获取。

获取凭证

接口说明

在使用通用接口前，你需要做以下两步工作：

1.拥有一个微信公众账号，并获取到appid和appsecret（在公众平台申请内测资格，审核通过后可获得）

2.通过获取凭证接口获取到access_token

注意：

access_token是第三方访问api资源的票据；
access_token对应于公众号是全局唯一的票据，重复获取将导致上次获取的access_token失效。

 

请求说明

http请求方式: GET
https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=APPID&secret=APPSECRET

 

参数说明

参数	是否必须	说明
grant_type	是	获取access_token填写client_credential
appid	是	第三方用户唯一凭证
secret	是	第三方用户唯一凭证密钥，既appsecret

 

返回说明

正确的Json返回结果:

{"access_token":"ACCESS_TOKEN","expires_in":7200}

 

参数	说明
access_token	获取到的凭证
expires_in	凭证有效时间，单位：秒

错误的Json返回示例:

{"errcode":40013,"errmsg":"invalid appid"}