GET /openapi/v1/tldb/wire
查询导地线参数库，需作用域 tldb:read。
请求参数
| 参数 | 说明 | 默认 |
|---|---|---|
| name | 精确型号查询，命中返回单条对象；未命中返回 404 | — |
| q | 模糊搜索，如 400/50、LGJ | — |
| page | 页码，从 1 开始 | 1 |
| pageSize | 每页条数，最大 200 | 50 |
示例
# 模糊搜索
curl "https://tool.0cai.net/openapi/v1/tldb/wire?q=400/50&pageSize=20" \
-H "Authorization: Bearer YOUR_KEY"
# 精确查单条
curl "https://tool.0cai.net/openapi/v1/tldb/wire?name=JL/G1A-400/50%20(GB/T%201179-2017)" \
-H "Authorization: Bearer YOUR_KEY"
返回结构
列表模式返回 {success, total, page, pageSize, data:[...]}；data 每项含：
| 字段 | 含义 | 单位 |
|---|---|---|
| name | 导线型号（含标准版本） | — |
| d | 外径 | mm |
| S / S_Al | 总截面 / 铝（或铝合金）截面 | mm² |
| n_Al | 铝单线根数 | 根 |
| R20 | 20℃ 直流电阻 | Ω/km |
| alpha | 电阻温度系数 | 1/℃ |
| S1 | 钢芯外径 | mm |
| Np / Npm | 额定拉断力 / 计算拉断力 | N |
| W / E / alf | 单重 / 弹性模量 / 线膨胀系数 | kg/km · MPa · 1/℃ |
省钱提示：导线库条目很稳定，建议把查询结果缓存到本地，不要每次计算前都查一遍。
GET /openapi/v1/tldb/search（全局搜索）
跨全部 10 个参数库模糊检索 name 字段：导地线 wire / 气象区 weather / 绝缘子 insulator / 金具 fittings / 金具串 fittings_assembly / 铁塔 tower / 接地 grounding / 地脚螺栓 anchor_bolt / 基础 foundation / 物资编码 material_code。需作用域 tldb:read。
典型用途：拿到一个型号或代号（如塔型 V3-5D1W1-Z1-60、地脚螺栓 4M36×240），不知道它在哪个库时，一把搜出来；响应里 db_key / db_name 会标明命中的库。
# 全局搜地脚螺栓（跨 10 库）
curl "https://tool.0cai.net/openapi/v1/tldb/search?keyword=4M36&limit=3" \
-H "Authorization: Bearer YOUR_KEY"
# 限定只搜铁塔库
curl "https://tool.0cai.net/openapi/v1/tldb/search?keyword=5D1W1-Z1-60&db=tower" \
-H "Authorization: Bearer YOUR_KEY"
请求参数
| 参数 | 说明 | 默认 |
|---|---|---|
| keyword | 必填，搜索关键字，至少 2 个字符；% 和 _ 按普通文本处理（不做通配符） | — |
| db | 可选，限定单库（取值见上方 10 个 db_key），不传则跨全库 | — |
| limit | 每个库最多返回条数，最大 50 | 10 |
返回结构
{success, keyword, db, per_lib_limit, matched_libs, total, data:[...]}，其中 matched_libs 是命中库摘要（db_key / db_name / count），data 每项为：
| 字段 | 含义 |
|---|---|
| db_key / db_name | 命中的库标识与库名（如 tower / 铁塔库） |
| id | 该库内条目 id |
| fields | 该条目完整字段（不含时间戳），随库不同而不同 |
与
/tldb/wire 的分工：确定要查导线时用 /tldb/wire（支持精确 name、分页）；
不确定在哪个库、或要查铁塔/螺栓/金具等其它参数时，用 /tldb/search 一把搜。
