📚 开放 API 接口文档

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

Base URL 与路径

  • Base URL:https://tool.0cai.net/openapi/v1(HTTP 会 301 到 HTTPS,请直接用 HTTPS)
  • 路径规则:/{工具}/{动作},例如 /zlljs/calc、/tldb/wire
  • 能力清单:GET /openapi/v1(不带子路径)返回当前全部可用接口

方法与参数

  • GET 与 POST 都支持,效果相同。
  • 参数既可以放 query string,也可以放 JSON body,服务端自动合并(同名时 body 优先)。
  • POST 建议加 Content-Type: application/json,body 为标准 JSON 对象。
  • 数字请用纯数字(不要带单位、逗号或百分号);温度默认摄氏度、风速 m/s、日照 W/m²。
  • 数组型参数(如坐标 coords)用 JSON 数组,不要拼字符串。

CORS

已开启 CORS,浏览器端可直接跨域调用——但仍不推荐在前端暴露 Key(见 鉴权)。

超时与重试

  • 建议客户端超时 ≥ 15s(CAD/坐标类接口涉及文件生成,可能稍慢)。
  • 429 表示配额用尽,不要立即重试,等次日 0 点(北京时间)重置。
  • 5xx 可退避重试 1–2 次,并记录 request_id。
就绪 塔基: 0 粤公网安备44060502004295号 粤ICP备2026039854号-1