接口說明
接口英文名
clearQuotaByAppSecret
功能描述
本接口用于清空公眾號(hào)/小程序等接口的每日調(diào)用接口次數(shù)
注意事項(xiàng)
1、該接口通過appsecret調(diào)用，解決了accesss_token耗盡無法調(diào)用重置 API 調(diào)用次數(shù)的情況
2、每個(gè)賬號(hào)每月使用重置 API 調(diào)用次數(shù) 與本接口共10次清零操作機(jī)會(huì)，清零生效一次即用掉一次機(jī)會(huì)；
3、由于指標(biāo)計(jì)算方法或統(tǒng)計(jì)時(shí)間差異，實(shí)時(shí)調(diào)用量數(shù)據(jù)可能會(huì)出現(xiàn)誤差，一般在1%以內(nèi)
4、該接口僅支持POST調(diào)用
調(diào)用方式
HTTPS 調(diào)用
POST https://api.weixin.qq.com/cgi-bin/clear_quota/v2 請(qǐng)求參數(shù)
| 屬性 | 類型 | 必填 | 說明 |
|---|---|---|---|
| appid | string | 是 | 要被清空的公眾號(hào)賬號(hào)的appid |
| appsecret | string | 是 | 唯一憑證密鑰，即 AppSecret，獲取方式同 appid |
返回參數(shù)
| 屬性 | 類型 | 說明 |
|---|---|---|
| errcode | number | 錯(cuò)誤碼 |
| errmsg | string | 錯(cuò)誤信息 |
調(diào)用示例
示例說明: post請(qǐng)求
請(qǐng)求數(shù)據(jù)示例
POST https://api.weixin.qq.com/cgi-bin/clear_quota/v2?appid=wx888888888888&appsecret=xxxxxxxxxxxxxxxxxxxxxxxx 返回?cái)?shù)據(jù)示例
{
"errcode": 0,
"errmsg": "ok"
}
錯(cuò)誤碼
| 錯(cuò)誤碼 | 錯(cuò)誤碼取值 | 解決方案 |
|---|---|---|
| -1 | system error | 系統(tǒng)繁忙，此時(shí)請(qǐng)開發(fā)者稍候再試 |
| 40013 | invalid appid | 不合法的 AppID ，請(qǐng)開發(fā)者檢查 AppID 的正確性，避免異常字符，注意大小寫 |
| 41004 | appsecret missing | 缺少 secret 參數(shù) |
| 41002 | appid missing | 缺少 appid 參數(shù) |
| 48006 | forbid to clear quota because of reaching the limit | api 禁止清零調(diào)用次數(shù)，因?yàn)榍辶愦螖?shù)達(dá)到上限 |
