重置API调用次数

重置API调用次数

调试工具

接口应在服务器端调用，详细说明参见服务端API。

接口说明

接口英文名

clearQuota

功能描述

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

注意事项

1、如果要清空公众号的接口的quota，则需要用公众号的access_token；如果要清空小程序的接口的quota，则需要用小程序的access_token；如果要清空第三方平台的接口的quota，则需要用第三方平台的component_access_token

2、如果是第三方服务商代公众号或者小程序清除quota，则需要用authorizer_access_token

3、每个账号每月共10次清零操作机会，清零生效一次即用掉一次机会；第三方帮助公众号/小程序调用时，实际上是在消耗公众号/小程序自身的quota

4、由于指标计算方法或统计时间差异，实时调用量数据可能会出现误差，一般在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

返回参数

属性	类型	说明
errcode	number	错误码
errmsg	string	错误信息

调用示例

示例说明: 请求示例：

请求数据示例

{
"appid":"wx448f04719cd48f69"
} 

返回数据示例

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

错误码

错误码	错误码取值	解决方案
48006	forbid to clear quota because of reaching the limit	api 禁止清零调用次数，因为清零次数达到上限
0	ok	ok
40013	invalid appid	不合法的 AppID ，请开发者检查 AppID 的正确性，避免异常字符，注意大小写