📚 开放 API 接口文档

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

GET POST /openapi/v1/zlljs/calc

依据 GB 50545-2010 / JCS 0374-2003 摩尔根公式,迭代求解交流电阻(k1 集肤效应、k2 磁滞涡流)与散热平衡(辐射 WR、对流 WF、日照吸热 Ws),得出允许载流量。需作用域 zlljs:calc。

返回值口径:响应里的 I 是总允许载流量,已含分裂根数 n 的倍数 (I = I_single × n);I_single 才是单根载流量。调用方直接取 I 即可,不必再乘一次 n。

最简调用:只给型号

curl "https://tool.0cai.net/openapi/v1/zlljs/calc?wire=LGJ-400/50&thetaA=40&thetaB=70&V=0.5" \ -H "Authorization: Bearer YOUR_KEY"

请求参数

参数说明默认
wire导线型号。给出后 d/S/S_Al/n_Al/dg/R20/alpha 自动从导线库补全(已手工给的值优先)。支持完整型号 JL/G1A-400/50 (GB/T 1179-2017)、简写 JL/G1A-400/50、旧型号 LGJ-400/50,乃至规格号 400/50—
thetaA环境温度 ℃。可为负值以模拟冬季低温工况(如 -5℃、-10℃)40
thetaB导线允许温度 ℃(必须大于 thetaA)70
V风速 m/s0.5
Js日照强度 W/m²1000
E1辐射系数0.9
As吸热系数0.9
n导线分裂根数。响应 I = I_single × n;传 0 或负数按 1 处理1
cosPhi功率因数0.95
f频率 Hz50
U电压等级 kV110
d / S / S_Al / n_Al / dg / R20 / alpha手工指定导线参数(外径 mm、总截面 mm²、铝截面 mm²、铝单线根数、钢芯外径 mm、20℃直流电阻 Ω/km、电阻温度系数)。不给 wire 时这些必填—

响应字段

字段含义
I总允许载流量 A(核心结果),= I_single × n
I_single单根(每相一根子导线)允许载流量 A
n实际采用的分裂根数
Rdc / Rac直流 / 交流电阻 Ω/m
k1 / k2集肤效应系数 / 磁滞涡流系数
WR / WF / Ws辐射散热 / 对流散热 / 日照吸热 W/m
dTheta导线与环境温差 K
Re / nu / lamf雷诺数 / 空气运动粘度 / 空气导热系数
wire回显实际命中的导线(名称、截面、外径、R20、额定拉断力)。模糊匹配时含 note 与 also_matched 候选列表
型号匹配规则(三级容错):精确 name → 模糊 LIKE %型号% → 抽取规格号再匹配,并把旧型号 LGJ- 映射到新国标 JL/G1A-。 多条命中时按「参数齐全 > JL/G1A > 含 GB/T 1179 > 最新录入」择优。请务必核对响应里 wire.name 是不是你要的那根线,有歧义时改传完整型号。

批量计算

需要算多组工况时循环调用即可(注意日配额)。也可以一次 POST 传多组:

curl -X POST "https://tool.0cai.net/openapi/v1/zlljs/calc" \ -H "Authorization: Bearer YOUR_KEY" -H "Content-Type: application/json" \ -d '{"wire":"400/50","thetaA":35,"thetaB":80,"V":1.0,"Js":1000}'
就绪 塔基: 0 粤公网安备44060502004295号 粤ICP备2026039854号-1