日配额
- 默认 1000 次/日/密钥,北京时间次日 0 点自动重置。
- 每次调用响应头都会回传剩余额度,客户端可据此做流控。
- 超限返回
429 quota_exceeded;可在个人中心为不同 Key 设置不同配额。
作用域与最小权限
- 申请时用空格分隔指定,如
zlljs:calc tldb:read;*表示全部。 - 生产环境建议按需授权:AI 助手只给计算类,数据同步脚本只给读取类。
吊销与轮换
- 怀疑泄露立刻到个人中心吊销(可再申请新的)。吊销不是删除,记录与日志保留。
- 建议定期轮换关键业务的 Key,并为不同用途使用不同 Key,缩小爆炸半径。
调用礼仪
- 不要高频轮询:导线参数库条目稳定,建议本地缓存,别每次计算前都查一遍。
- 批量场景合并请求(如一次传多组工况),而不是循环发几百次。
- 429 时尊重重置时间,不要用多把 Key 绕过硬限。
用量与审计
- 所有调用都记入
api_logs(endpoint / 状态码 / IP / 时间)。 - 管理员可在后台「用户API管理」按密钥、接口、时间范围查看与统计。