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/s | 0.5 |
| Js | 日照强度 W/m² | 1000 |
| E1 | 辐射系数 | 0.9 |
| As | 吸热系数 | 0.9 |
| n | 导线分裂根数。响应 I = I_single × n;传 0 或负数按 1 处理 | 1 |
| cosPhi | 功率因数 | 0.95 |
| f | 频率 Hz | 50 |
| U | 电压等级 kV | 110 |
| 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}'