📚 开放 API 接口文档

用 API Key 让 AI / 脚本直接调用本站的计算与数据能力

日配额

  • 默认 1000 次/日/密钥,北京时间次日 0 点自动重置。
  • 每次调用响应头都会回传剩余额度,客户端可据此做流控。
  • 超限返回 429 quota_exceeded;可在个人中心为不同 Key 设置不同配额。

作用域与最小权限

  • 申请时用空格分隔指定,如 zlljs:calc tldb:read;* 表示全部。
  • 生产环境建议按需授权:AI 助手只给计算类,数据同步脚本只给读取类。

吊销与轮换

  • 怀疑泄露立刻到个人中心吊销(可再申请新的)。吊销不是删除,记录与日志保留。
  • 建议定期轮换关键业务的 Key,并为不同用途使用不同 Key,缩小爆炸半径。

调用礼仪

  • 不要高频轮询:导线参数库条目稳定,建议本地缓存,别每次计算前都查一遍。
  • 批量场景合并请求(如一次传多组工况),而不是循环发几百次。
  • 429 时尊重重置时间,不要用多把 Key 绕过硬限。

用量与审计

  • 所有调用都记入 api_logs(endpoint / 状态码 / IP / 时间)。
  • 管理员可在后台「用户API管理」按密钥、接口、时间范围查看与统计。
就绪 塔基: 0 粤公网安备44060502004295号 粤ICP备2026039854号-1