D黑奴背锅 文档中心
运维与限制

接口额度

了解 OpenAPI 的分钟、每日与每月额度,以及查询剩余额度的方法。

OpenAPI 默认按应用维度限制调用额度。接口可以配置独立额度和单次消耗,具体值以接口参考中的“调用额度”为准。

系统默认额度

周期默认额度说明
每分钟60默认调用额度。
每天1000默认调用额度。
每月不限默认不限制月额度。
单次成本1默认每次请求扣减 1。

查询剩余额度

get_quota 接口本身不消耗 OpenAPI 额度:

curl "https://api.dibinos.cn/openapi/v1/get_quota?api_path=/openapi/v1/get_weather" \
  -H "Authorization: Bearer ACCESS_TOKEN"
{
  "code": 0,
  "message": "额度查询成功",
  "data": {
    "api_path": "/openapi/v1/get_weather",
    "scope": "global",
    "cost": 3,
    "periods": [
      {
        "period": "minute",
        "limit": 60,
        "used": 6,
        "remaining": 54,
        "unlimited": false,
        "reset_at": 1779502580
      }
    ]
  },
  "time": 1779502528
}
  • limit 为周期上限,0 表示不限额。
  • remaining 为当前周期剩余额度。
  • reset_at 为该周期下一次重置的时间戳。
  • scope 表示命中的规则来源,可能为 clientglobalsystem

超限处理

额度耗尽时接口返回 HTTP 429。应用应停止立即重试,等待对应周期的 reset_at 后恢复调用,并根据业务重要性实施退避或降级。

On this page