# 查询API调用额度
接口应在服务器端调用,详细说明参见服务端API。
# 接口说明
# 接口英文名
getApiQuota
# 功能描述
本接口用于查询公众号/小程序/第三方平台等接口的每日调用接口的额度,调用次数,频率限制
# 注意事项
1、如果查询的api属于公众号的接口,则需要用公众号的access_token;如果查询的api属于小程序的接口,则需要用小程序的access_token;如果查询的接口属于第三方平台的接口,则需要用第三方平台的component_access_token;如果查询的接口属于第三方平台接口但用于公众号/小程序,则需要用第三方平台的authorizer_access_token
2、如果是第三方服务商代公众号或者小程序查询公众号或者小程序的api,则需要用authorizer_access_token
3、每个接口都有调用次数限制,请开发者合理调用接口
4、”/xxx/sns/xxx“这类接口不支持使用该接口,会出现76022报错。
5、如果业务api定义了业务上的quota,那么以业务api的quota为准
# 调用方式
# HTTPS 调用
POST https://api.weixin.qq.com/cgi-bin/openapi/quota/get?access_token=ACCESS_TOKEN
# 第三方调用
- 调用方式以及出入参和HTTPS相同,仅是调用的token不同
# 请求参数
属性 | 类型 | 必填 | 说明 |
---|---|---|---|
access_token | string | 是 | 接口调用凭证,该参数为 URL 参数,非 Body 参数。使用access_token或者authorizer_access_token |
cgi_path | string | 是 | api的请求地址,例如"/cgi-bin/message/custom/send";不要前缀“https://api.weixin.qq.com” ,也不要漏了"/",否则都会76003的报错 |
# 返回参数
属性 | 类型 | 说明 | |||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
errcode | number | 返回码 | |||||||||||||||||
errmsg | string | 错误信息 | |||||||||||||||||
quota | object | quota详情 | |||||||||||||||||
| |||||||||||||||||||
rate_limit | object | 普通调用频率限制 | |||||||||||||||||
| |||||||||||||||||||
component_rate_limit | object | 代调用频率限制 | |||||||||||||||||
|
# 调用示例
示例说明: 请求示例:
# 请求数据示例
{
"cgi_path":"/wxa/gettemplatedraftlist"
}
# 返回数据示例
{
"errcode": 0,
"errmsg": "ok",
"quota":{
"daily_limit": 0,
"used": 0,
"remain": 0
}
}
# 错误码
错误码 | 错误描述 | 解决方案 |
---|---|---|
0 | ok | ok |
76021 | cgi_path not found, please check | cgi_path填错了 |
76022 | could not use this cgi_path,no permission | 当前调用接口使用的token与api所属账号不符,详情可看注意事项的说明 |