微信公众平台开发 ACCESS TOKEN

来源:互联网 发布:编程猫学校 编辑:程序博客网 时间:2024/04/24 20:53

 

获取access token

返回

access_token是公众号的全局唯一票据,公众号调用各接口时都需使用access_token。正常情况下access_token有效期为7200秒,重复获取将导致上次获取的access_token失效。

公众号可以使用AppID和AppSecret调用本接口来获取access_token。AppID和AppSecret可在开发模式中获得(需要已经成为开发者,且帐号没有异常状态)。注意调用所有微信接口时均需使用https协议。

接口调用请求说明

http请求方式: GEThttps://api.weixin.qq.com/cgi-bin/token?grant_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数据包示例如下(该示例为AppID无效错误):

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

全局返回码说明

 

全局返回码说明

返回

公众号每次调用接口时,可能获得正确或错误的返回码,开发者可以根据返回码信息调试接口,排查错误。

全局返回码说明如下:

返回码说明-1系统繁忙0请求成功40001获取access_token时AppSecret错误,或者access_token无效40002不合法的凭证类型40003不合法的OpenID40004不合法的媒体文件类型40005不合法的文件类型40006不合法的文件大小40007不合法的媒体文件id40008不合法的消息类型40009不合法的图片文件大小40010不合法的语音文件大小40011不合法的视频文件大小40012不合法的缩略图文件大小40013不合法的APPID40014不合法的access_token40015不合法的菜单类型40016不合法的按钮个数40017不合法的按钮个数40018不合法的按钮名字长度40019不合法的按钮KEY长度40020不合法的按钮URL长度40021不合法的菜单版本号40022不合法的子菜单级数40023不合法的子菜单按钮个数40024不合法的子菜单按钮类型40025不合法的子菜单按钮名字长度40026不合法的子菜单按钮KEY长度40027不合法的子菜单按钮URL长度40028不合法的自定义菜单使用用户40029不合法的oauth_code40030不合法的refresh_token40031不合法的openid列表40032不合法的openid列表长度40033不合法的请求字符,不能包含\uxxxx格式的字符40035不合法的参数40038不合法的请求格式40039不合法的URL长度40050不合法的分组id40051分组名字不合法41001缺少access_token参数41002缺少appid参数41003缺少refresh_token参数41004缺少secret参数41005缺少多媒体文件数据41006缺少media_id参数41007缺少子菜单数据41008缺少oauth code41009缺少openid42001access_token超时42002refresh_token超时42003oauth_code超时43001需要GET请求43002需要POST请求43003需要HTTPS请求43004需要接收者关注43005需要好友关系44001多媒体文件为空44002POST的数据包为空44003图文消息内容为空44004文本消息内容为空45001多媒体文件大小超过限制45002消息内容超过限制45003标题字段超过限制45004描述字段超过限制45005链接字段超过限制45006图片链接字段超过限制45007语音播放时间超过限制45008图文消息超过限制45009接口调用超过限制45010创建菜单个数超过限制45015回复时间超过限制45016系统分组,不允许修改45017分组名字过长45018分组数量超过上限46001不存在媒体数据46002不存在的菜单版本46003不存在的菜单数据46004不存在的用户47001解析JSON/XML内容错误48001api功能未授权50001用户未授权该api

 

接口频率限制说明

返回

公众号调用接口并不是无限制的。为了防止公众号的程序错误而引发微信服务器负载异常,默认情况下,每个公众号调用接口都不能超过一定限制,当超过一定限制时,调用对应接口会收到如下错误返回码:

{"errcode":45009,"errmsg":"api freq out of limit"}

各接口调用频率限制如下:

接口每日限额获取access_token2000自定义菜单创建1000自定义菜单查询10000自定义菜单删除1000创建分组1000获取分组1000修改分组名1000移动用户分组100000上传多媒体文件5000下载多媒体文件10000发送客服消息500000获取带参数的二维码10000获取关注者列表500获取用户基本信息5000000获取网页授权access_token2000000刷新网页授权access_token2000000网页授权获取用户信息2000000

 

 

 

0 0
原创粉丝点击