# 使用AppSecret重置API调用次数

接口应在服务器端调用,不可在前端(小程序、网页、APP等)直接调用,具体可参考接口调用指南

接口英文名:clearQuotaByAppSecret

本接口用于清空公众号/服务号/小程序/小游戏/微信小店/带货助手/视频号助手/联盟带货机构/移动应用/网站应用/多端应用等接口的每日调用接口次数。

# 1. 调用方式

# HTTPS 调用

POST https://api.weixin.qq.com/cgi-bin/clear_quota/v2

# 云调用

  • 本接口不支持云调用

# 第三方调用

  • 本接口不支持第三方平台调用。

# 2. 请求参数

# 查询参数 Query String parameters

# 请求体 Request Payload

参数名类型必填说明
appidstring要被清空的账号的appid
appsecretstring唯一凭证密钥,即 AppSecret

# 3. 返回参数

# 返回体 Response Payload

# 4. 注意事项

1、该接口通过 appsecret 调用,解决了 accesss_token 耗尽无法调用「重置 API 调用次数」的问题。

2、每个帐号每月使用「重置 API 调用次数」与本接口共10次清零操作机会,清零生效一次即用掉一次机会;

3、由于指标计算方法或统计时间差异,实时调用量数据可能会出现误差,一般在1%以内

4、该接口仅支持POST调用

5、如果要清除getComponentAccessToken调用次数或者以服务商身份代商家清除公众号或者小程序调用次数,则需要使用clearComponentQuotaByAppSecret 接口。

# 5. 代码示例

请求示例

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

返回示例

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

# 6. 错误码

以下是本接口的错误码列表,其他错误码可参考 通用错误码

错误码错误描述解决方案
-1system error系统繁忙,此时请开发者稍候再试
40013invalid appid不合法的 AppID ,请开发者检查 AppID 的正确性,避免异常字符,注意大小写
41002appid missing缺少 appid 参数
41004appsecret missing缺少 secret 参数
48006forbid to clear quota because of reaching the limitapi 禁止清零调用次数,因为清零次数达到上限

# 7. 适用范围

本接口在不同账号类型下的可调用情况:
小程序公众号服务号小游戏微信小店联盟带货机构带货助手移动应用网站应用视频号助手多端应用
  • ✔:该账号可调用此接口
  • 其他未明确声明的账号类型,如无特殊说明,均不可调用此接口;