openApi管理 /重置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 | 是 | 第三方平台接口调用凭证authorizer_access_token，该参数为 URL 参数，非 Body 参数。 |
| 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 的正确性，避免异常字符，注意大小写 |