# 使用AppSecret重置 API 调用次数

# 接口说明

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

# 注意事项

  • 该接口通过appsecret调用,解决了accesss_token耗尽无法调用重置 API 调用次数 的情况;
  • 每个账号每月使用重置 API 调用次数 与本接口共10次清零操作机会,清零生效一次即用掉一次机会;
  • 由于指标计算方法或统计时间差异,实时调用量数据可能会出现误差,一般在1%以内;
  • 该接口仅支持POST调用;
  • 如果要清除getComponentAccessToken调用次数或者以服务商身份代商家清除公众号或者小程序调用次数,则需要使用clearComponentQuotaByAppSecret。

# 接口调用请求说明

POST https://api.weixin.qq.com/cgi-bin/clear_quota/v2?appid=APPID&appsecret=APPSECRET

# 请求参数说明

参数 类型 是否必填 描述
appid string 要被清空的账号的appid,该参数为 URL 参数,非 Body 参数
appsecret string 唯一凭证密钥,即 AppSecret,获取方式同 appid,该参数为 URL 参数,非 Body 参数

# 请求参数示例

POST  https://api.weixin.qq.com/cgi-bin/clear_quota/v2?appid=wx888888888888&appsecret=589sxxxxxxxxxxxxxxxxxxxx

# 返回参数说明

属性 类型 描述
errcode number 错误码
errmsg string 错误信息

# 返回参数示例

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

# 错误码

错误码 错误码取值 错误描述
公共错误码 - -
40013 invalid appid 不合法的 appid ,请开发者检查 appid 的正确性,避免异常字符,注意大小写
41004 appsecret missing 缺少 appsecret 参数,请开发者确认是否有传递该参数
41002 appid missing 缺少 appid 参数,请开发者确认是否有传递该参数
48006 forbid to clear quota because of reaching the limit api 禁止清零调用次数,因为清零次数达到上限