运维与限制
接口额度
了解 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表示命中的规则来源,可能为client、global或system。
超限处理
额度耗尽时接口返回 HTTP 429。应用应停止立即重试,等待对应周期的 reset_at 后恢复调用,并根据业务重要性实施退避或降级。