# 查询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详情
属性 类型 说明
daily_limit number 当天该账号可调用该接口的次数
used number 当天已经调用的次数
remain number 当天剩余调用次数
rate_limit object 普通调用频率限制
属性 类型 说明
call_count number 周期内可调用数量,单位 次
refresh_second number 更新周期,单位 秒
component_rate_limit object 代调用频率限制
属性 类型 说明
call_count number 周期内可调用数量,单位 次
refresh_second number 更新周期,单位 秒

# 调用示例

示例说明: 请求示例:

# 请求数据示例


{
"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所属账号不符,详情可看注意事项的说明