# 查询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详情
参数 类型 描述
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 更新周期,单位 秒

# 返回参数示例

{
  "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所属账号不符,详情可参考上方注意事项