使用AppSecret重置第三方平台API调用次数

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

接口英文名：clearComponentQuotaByAppSecret

本接口用于清空公众号/小程序/第三方等接口的每日调用接口次数

1. 调用方式

HTTPS 调用

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

云调用

• 本接口不支持云调用。

第三方调用

• 本接口仅支持第三方平台使用 component_access_token 自己调用。

2. 请求参数

查询参数 Query String Parameters

无

请求体 Request Payload

3. 返回参数

返回体 Response Payload

4. 注意事项

1、该接口通过appsecret调用，解决了accesss_token耗尽无法调用重置 API 调用次数 的情况

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

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

4、该接口仅支持POST调用

5、该接口可以代公众号/小程序用户重置接口调用次数，appid参数需要是已授权的账号。

5. 代码示例

5.1 重置第三方账号API调用次数

请求示例

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

{
    "component_appid":"wxxxxxxxxxxxxxxxxxx",
    "appsecret":"xxxxxxxxxxxxxxxxxxxxxxxx"
}

返回示例

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

5.2 代公众号/小程序重置API调用次数

请求示例

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

{
    "appid":"wxxxxxxxxxxxxxxxxxx",
    "component_appid":"wxxxxxxxxxxxxxxxxxx",
    "appsecret":"xxxxxxxxxxxxxxxxxxxxxxxx"
}

返回示例

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

6. 错误码

以下是本接口的错误码列表，其他错误码可参考 通用错误码；调用接口遇到报错，可使用官方提供的 API 诊断工具 辅助定位和分析问题。

7. 适用范围

本接口支持「第三方平台」账号类型调用。其他账号类型如无特殊说明，均不可调用。