# 重置API调用次数

调试工具

# 接口说明

  • 本接口使用access_token清空公众号/小程序/第三方平台等接口的每日调用接口次数;
  • 接口应在服务器端调用,详细说明参见服务端API

# 注意事项

  • 如果要清空公众号的接口的quota,则需要用公众号的access_token;如果要清空小程序的接口的quota,则需要用小程序的access_token;如果要清空第三方平台的接口的quota,则需要用第三方平台的component_access_token
  • 如果是第三方服务商代公众号或者小程序清除quota,则需要用authorizer_access_token
  • 每个账号每月共10次清零操作机会,清零生效一次即用掉一次机会;第三方帮助公众号/小程序调用时,实际上是在消耗公众号/小程序自身的quota;
  • 由于指标计算方法或统计时间差异,实时调用量数据可能会出现误差,一般在1%以内。

# 接口调用请求说明

# HTTPS 调用

POST https://api.weixin.qq.com/cgi-bin/clear_quota?access_token=ACCESS_TOKEN 

# 第三方调用

调用方式以及出入参和HTTPS相同,仅是调用的token不同

# 请求参数说明

参数 类型 是否必填 描述
access_token string 接口调用凭证,该参数为 URL 参数,非 Body 参数。使用access_token或者authorizer_access_token
appid string 要被清空的账号的appid

# 请求参数示例

{
"appid":"wx448f04719cd48f69"
} 

# 返回参数说明

参数 类型 描述
errcode number 错误码
errmsg string 错误信息

# 返回数据示例

{
  "errcode": 0,
  "errmsg": "ok"
} 

# 错误码

错误码 错误码取值 错误描述
公共错误码 - -
40001 invalid credential, access_token is invalid or not latest 不合法的或者不是最新的 access_token
40013 invalid appid 不合法的 appid ,请开发者检查 appid 的正确性,避免异常字符,注意大小写
41001 access_token missing 缺少 access_token 参数,请开发者确认是否有传递该参数
41002 appid missing 缺少 appid 参数,请开发者确认是否有传递该参数
42001 access_token expired access_token 过期,请开发者重新获取有效的access_token后再试
44002 empty post data POST 的数据为空
45009 reach max api daily quota limit api 调用次数达到当天上限
48006 forbid to clear quota because of reaching the limit api 禁止清零调用次数,因为清零次数达到上限
50002 user limited appid 用户功能受限