工具

查询额度

查询当前应用的 OpenAPI 剩余额度。

请求地址

GET/openapi/v1/get_quota

请求参数

参数类型必填说明

api_pathstring否接口路径，不传时查询默认额度，如 /openapi/v1/get_weather。

返回参数

参数名类型描述

data.client_idstring当前 OAuth 应用 ID。

data.api_pathstring查询的接口路径。

data.rule_api_pathstring实际命中的额度规则路径。

data.scopestring规则来源，client、global 或 system。

data.costnumber单次调用消耗额度。

data.periodsarray额度周期列表。

data.periods[].periodstring周期，minute、day 或 month。

data.periods[].limitnumber周期额度，0 表示不限额。

data.periods[].usednumber当前周期已使用额度。

data.periods[].remainingnumber当前周期剩余额度。

data.periods[].unlimitedboolean当前周期是否不限额。

data.periods[].reset_atnumber当前周期重置时间戳。

接口说明

该接口不消耗 OpenAPI 额度。

request

1curl "https://api.dibinos.cn/openapi/v1/get_quota?api_path=/openapi/v1/get_weather" \2-H "Authorization: Bearer ACCESS_TOKEN"

response

1{2  "code": 0,3  "message": "额度查询成功",4  "data": {5    "client_id": "oauth_client_id",6    "api_path": "/openapi/v1/get_weather",7    "rule_api_path": "/openapi/v1/get_weather",8    "scope": "global",9    "cost": 3,10    "periods": [11      {12        "period": "minute",13        "limit": 60,14        "used": 6,15        "remaining": 54,16        "unlimited": false,17        "reset_at": 177950258018      },19      {20        "period": "day",21        "limit": 1000,22        "used": 30,23        "remaining": 970,24        "unlimited": false,25        "reset_at": 177955200026      },27      {28        "period": "month",29        "limit": 30000,30        "used": 90,31        "remaining": 29910,32        "unlimited": false,33        "reset_at": 178024320034      }35    ]36  },37  "time": 177950252838}