# 查询API调用额度
# 接口说明
本接口用于查询视频号/公众号/小程序/第三方平台等接口的每日调用接口的额度,调用次数,频率限制;
接口应在服务器端调用,详细说明参见服务端API。
# 注意事项
如果查询的api属于公众号的接口,则需要用公众号的access_token;如果查询的api属于小程序的接口,则需要用小程序的access_token;如果查询的接口属于第三方平台的接口,则需要用第三方平台的component_access_token;
如果是第三方服务商代公众号或者小程序查询公众号或者小程序的api,则需要用authorizer_access_token;
每个接口都有调用次数限制,请开发者合理调用接口;
“/xxx/sns/xxx”这类接口不支持使用该接口,会出现76022报错;
如果业务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的报错 |
# 请求参数示例
{
"cgi_path":"/wxa/gettemplatedraftlist"
}
# 返回参数说明
参数 | 类型 | 描述 | |||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
errcode | number | 返回码 | |||||||||||||||||
errmsg | string | 错误信息 | |||||||||||||||||
quota | object | quota详情 | |||||||||||||||||
| |||||||||||||||||||
rate_limit | object | 普通调用频率限制 | |||||||||||||||||
| |||||||||||||||||||
component_rate_limit | object | 代调用频率限制 | |||||||||||||||||
|
# 返回参数示例
{
"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所属账号不符,详情可参考上方注意事项 |