> 微信公众号开发手册 > 微信公众号接口调用频次限制说明

接口调用频次限制说明


微信公众号接口调用频次限制说明

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

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

开发者可以登录微信公众平台,在帐号后台开发者中心接口权限模板查看帐号各接口当前的日调用上限和实时调用量,对于认证帐号可以对实时调用量清零,说明如下:

  1. 由于指标计算方法或统计时间差异,实时调用量数据可能会出现误差,一般在1%以内。
  2. 每个帐号每月共10次清零操作机会,清零生效一次即用掉一次机会(10次包括了平台上的清零和调用接口API的清零)。
  3. 第三方帮助公众号调用时,实际上是在消耗公众号自身的quota。
  4. 每个有接口调用限额的接口都可以进行清零操作。

新注册帐号各接口调用频率限制如下:


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


请注意,在测试号申请页中申请的测试号,接口调用频率限制如下:

接口 每日限额
获取access_token 200
自定义菜单创建 100
自定义菜单查询 1000
自定义菜单删除 100
创建分组 100
获取分组 100
修改分组名 100
移动用户分组 1000
素材管理-临时素材上传 500
素材管理-临时素材下载 1000
发送客服消息 50000
获取带参数的二维码 10000
获取关注者列表 100
获取用户基本信息 500000
获取网页授权access_token
刷新网页授权access_token
网页授权获取用户信息

公众号调用或第三方平台帮公众号调用对公众号的所有api调用(包括第三方帮其调用)次数进行清零:

1
2
3
Http请求:POST
HTTP调用:
https://api.weixin.qq.com/cgi-bin/clear_quota?access_token=ACCESS_TOKEN

调用示例:

1
2
3
{
“appid”:“APPID”
}
参数说明:
参数 是否必须 说明
access_token 调用接口凭据
appid 公众号的APPID
正常情况下,会返回:
1
2
3
4
{
"errcode":0,
"errmsg":"ok"
}
如果调用超过限制次数,则返回:
1
2
3
4
{
"errcode":48006,
"errmsg":"forbid to clear quota because of reaching the limit"
}
微信公众号接口调用频次限制说明