# 使用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 禁止清零调用次数,因为清零次数达到上限 |