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。