# 使用AppSecret重置第三方平台 API 调用次数
接口应在服务器端调用,详细说明参见服务端API。
# 接口说明
# 接口英文名
clearComponentQuotaByAppSecret
# 功能描述
本接口用于清空公众号/小程序/第三方等接口的每日调用接口次数
# 注意事项
1、该接口通过appsecret调用,解决了accesss_token耗尽无法调用重置 API 调用次数 的情况
2、每个账号每月使用重置 API 调用次数 与本接口共10次清零操作机会,清零生效一次即用掉一次机会;
3、由于指标计算方法或统计时间差异,实时调用量数据可能会出现误差,一般在1%以内
4、该接口仅支持POST调用
5、该接口可以代公众号/小程序用户重置接口调用次数,appid参数需要是已授权的账号。
# 调用方式
# HTTPS 调用
POST https://api.weixin.qq.com/cgi-bin/component/clear_quota/v2
# 请求参数
属性 | 类型 | 必填 | 说明 |
---|---|---|---|
appid | string | 是 | 授权用户appid |
component_appid | string | 是 | 第三方appid |
appsecret | string | 是 | 第三方appsecret |
# 返回参数
属性 | 类型 | 说明 |
---|---|---|
errcode | number | 错误码 |
errmsg | string | 错误信息 |
# 调用示例
示例说明: 重置第三方账号API调用次数
# 请求数据示例
POST https://api.weixin.qq.com/cgi-bin/component/clear_quota/v2
{
"component_appid":"wxxxxxxxxxxxxxxxxxx",
"appsecret":"xxxxxxxxxxxxxxxxxxxxxxxx"
}
# 返回数据示例
{
"errcode": 0,
"errmsg": "ok"
}
示例说明: 代公众号/小程序重置API调用次数
# 请求数据示例
POST https://api.weixin.qq.com/cgi-bin/component/clear_quota/v2
{
"appid":"wxxxxxxxxxxxxxxxxxx",
"component_appid":"wxxxxxxxxxxxxxxxxxx",
"appsecret":"xxxxxxxxxxxxxxxxxxxxxxxx"
}
# 返回数据示例
{
"errcode": 0,
"errmsg": "ok"
}
# 错误码
错误码 | 错误码取值 | 解决方案 |
---|---|---|
-1 | system error | 系统繁忙,此时请开发者稍候再试 |
40013 | invalid appid | 不合法的 AppID ,请开发者检查 AppID 的正确性,避免异常字符,注意大小写 |
41004 | appsecret missing | 缺少 secret 参数 |
41002 | appid missing | 缺少 appid 参数 |
48006 | forbid to clear quota because of reaching the limit | api 禁止清零调用次数,因为清零次数达到上限 |
43007 | require bizuser authorize | 检查授权关系 |