{ "openapi": "3.0.3", "info": { "title": "tool.0cai.net 输电工具箱开放 API", "version": "1.0.0", "description": "面向 AI 助手与自动化脚本的输电专业计算/数据接口。\n\n鉴权：在请求头携带 `Authorization: Bearer <你的API Key>`（也支持 `X-API-Key: `）。\n密钥请在个人中心 → 开放API密钥 申请：https://tool.0cai.net/user/index.php#apikey\n\n所有接口 GET 与 POST 均可调用，参数既可放 query string 也可放 JSON body。\n响应统一为 JSON，失败时含 `success:false` 与 `error` 错误码。日配额见响应头 `X-RateLimit-Remaining`。\n\n人类可读文档：https://tool.0cai.net/openapi/docs/", "contact": { "name": "tool.0cai.net", "url": "https://tool.0cai.net" } }, "servers": [ { "url": "https://tool.0cai.net/openapi/v1", "description": "生产环境" } ], "security": [ { "bearerAuth": [] } ], "paths": { "/zlljs/calc": { "get": { "summary": "导线载流量计算（摩尔根公式）", "operationId": "calcAmpacity", "description": "依据 GB 50545-2010 / JCS 0374-2003 摩尔根公式求导线允许载流量，迭代求解交流电阻（k1 集肤效应、k2 磁滞涡流）与散热平衡。最简调用只需 wire + thetaA + thetaB + V。返回的 I 是总允许载流量（已含分裂根数 n 的倍数），I_single 是单根载流量；thetaA 可为负值以模拟冬季低温工况。", "tags": [ "载流量" ], "security": [ { "bearerAuth": [] }, { "apiKeyHeader": [] } ], "parameters": [ { "name": "wire", "in": "query", "required": false, "description": "导线型号。给出后 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\"。模糊匹配时响应 wire.also_matched 会列出其他候选。", "schema": { "type": "string", "example": "LGJ-400/50" } }, { "name": "thetaA", "in": "query", "required": false, "description": "环境温度 ℃。可为负值以模拟冬季低温工况", "schema": { "type": "number", "default": 40 } }, { "name": "thetaB", "in": "query", "required": false, "description": "导线允许温度 ℃", "schema": { "type": "number", "default": 70 } }, { "name": "V", "in": "query", "required": false, "description": "风速 m/s", "schema": { "type": "number", "default": 0.5 } }, { "name": "Js", "in": "query", "required": false, "description": "日照强度 W/m²", "schema": { "type": "number", "default": 1000 } }, { "name": "E1", "in": "query", "required": false, "description": "辐射系数", "schema": { "type": "number", "default": 0.9 } }, { "name": "As", "in": "query", "required": false, "description": "吸热系数", "schema": { "type": "number", "default": 0.9 } }, { "name": "n", "in": "query", "required": false, "description": "导线分裂根数。响应 I = I_single × n；传 0 或负数按 1 处理", "schema": { "type": "integer", "default": 1 } }, { "name": "cosPhi", "in": "query", "required": false, "description": "功率因数", "schema": { "type": "number", "default": 0.95 } }, { "name": "f", "in": "query", "required": false, "description": "频率 Hz", "schema": { "type": "number", "default": 50 } }, { "name": "U", "in": "query", "required": false, "description": "电压等级 kV", "schema": { "type": "number", "default": 110 } }, { "name": "d", "in": "query", "required": false, "description": "导线外径 mm（不给 wire 时必填）", "schema": { "type": "number" } }, { "name": "S", "in": "query", "required": false, "description": "导线总截面 mm²", "schema": { "type": "number" } }, { "name": "S_Al", "in": "query", "required": false, "description": "铝截面 mm²（不给 wire 时必填）", "schema": { "type": "number" } }, { "name": "n_Al", "in": "query", "required": false, "description": "铝单线根数", "schema": { "type": "integer" } }, { "name": "dg", "in": "query", "required": false, "description": "钢芯外径 mm（不给 wire 时必填）", "schema": { "type": "number" } }, { "name": "R20", "in": "query", "required": false, "description": "20℃直流电阻 Ω/km（不给 wire 时必填）", "schema": { "type": "number" } }, { "name": "alpha", "in": "query", "required": false, "description": "电阻温度系数 1/℃", "schema": { "type": "number" } } ], "responses": { "200": { "description": "计算成功", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "example": true }, "I": { "type": "number", "description": "总允许载流量 A（核心结果）= I_single × n", "example": 1180.78 }, "I_single": { "type": "number", "description": "单根（每相一根子导线）允许载流量 A", "example": 590.39 }, "n": { "type": "integer", "description": "实际采用的分裂根数" }, "dTheta": { "type": "number", "description": "导线与环境温差 K" }, "Rdc": { "type": "number", "description": "计算温度下的直流电阻 Ω/m" }, "Rac": { "type": "number", "description": "交流电阻 Ω/m" }, "k1": { "type": "number", "description": "集肤效应系数" }, "k2": { "type": "number", "description": "磁滞/涡流（铁损）系数" }, "WR": { "type": "number", "description": "辐射散热 W/m" }, "WF": { "type": "number", "description": "对流散热 W/m" }, "Ws": { "type": "number", "description": "日照吸热 W/m" }, "Re": { "type": "number", "description": "雷诺数" }, "nu": { "type": "number", "description": "空气运动粘度 m²/s" }, "lamf": { "type": "number", "description": "空气导热系数 W/(m·K)" }, "wire": { "type": "object", "description": "仅当传入 wire 型号时返回，回显实际命中的导线", "properties": { "name": { "type": "string" }, "S": { "type": "number" }, "d": { "type": "number" }, "R20": { "type": "number" }, "Npm": { "type": "number" }, "note": { "type": "string" }, "also_matched": { "type": "array", "items": { "type": "string" } } } }, "request_id": { "type": "string" } } } } } }, "400": { "description": "参数缺失/导线参数不完整", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "缺少或无效的 API Key", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "密钥无该接口作用域（scope）", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "导线型号未找到", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "超出日配额", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "post": { "summary": "导线载流量计算（JSON body）", "operationId": "calcAmpacityPost", "description": "同 GET，参数以 JSON body 提交。推荐：{\\\"wire\\\":\\\"LGJ-400/50\\\",\\\"thetaA\\\":40,\\\"thetaB\\\":70,\\\"V\\\":0.5}", "tags": [ "载流量" ], "security": [ { "bearerAuth": [] }, { "apiKeyHeader": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "wire": { "type": "string", "example": "LGJ-400/50" }, "thetaA": { "type": "number", "example": 40 }, "thetaB": { "type": "number", "example": 70 }, "V": { "type": "number", "example": 0.5 }, "Js": { "type": "number", "example": 1000 }, "E1": { "type": "number", "example": 0.9 }, "As": { "type": "number", "example": 0.9 }, "n": { "type": "integer", "example": 1 }, "cosPhi": { "type": "number", "example": 0.95 }, "f": { "type": "number", "example": 50 }, "U": { "type": "number", "example": 110 } } } } } }, "responses": { "200": { "description": "计算成功", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "example": true }, "I": { "type": "number", "description": "总允许载流量 A（核心结果）= I_single × n", "example": 1180.78 }, "I_single": { "type": "number", "description": "单根（每相一根子导线）允许载流量 A", "example": 590.39 }, "n": { "type": "integer", "description": "实际采用的分裂根数" }, "dTheta": { "type": "number", "description": "导线与环境温差 K" }, "Rdc": { "type": "number", "description": "计算温度下的直流电阻 Ω/m" }, "Rac": { "type": "number", "description": "交流电阻 Ω/m" }, "k1": { "type": "number", "description": "集肤效应系数" }, "k2": { "type": "number", "description": "磁滞/涡流（铁损）系数" }, "WR": { "type": "number", "description": "辐射散热 W/m" }, "WF": { "type": "number", "description": "对流散热 W/m" }, "Ws": { "type": "number", "description": "日照吸热 W/m" }, "Re": { "type": "number", "description": "雷诺数" }, "nu": { "type": "number", "description": "空气运动粘度 m²/s" }, "lamf": { "type": "number", "description": "空气导热系数 W/(m·K)" }, "wire": { "type": "object", "description": "仅当传入 wire 型号时返回，回显实际命中的导线", "properties": { "name": { "type": "string" }, "S": { "type": "number" }, "d": { "type": "number" }, "R20": { "type": "number" }, "Npm": { "type": "number" }, "note": { "type": "string" }, "also_matched": { "type": "array", "items": { "type": "string" } } } }, "request_id": { "type": "string" } } } } } }, "400": { "description": "参数缺失/导线参数不完整", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "缺少或无效的 API Key", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "密钥无该接口作用域（scope）", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "导线型号未找到", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "超出日配额", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/tldb/wire": { "get": { "summary": "导线参数库查询", "operationId": "queryWires", "description": "查询本站导线参数库（tldb_wire）。不给 name/q 时分页返回全库；给 name 精确返回单条；给 q 模糊搜索。", "tags": [ "导线库" ], "security": [ { "bearerAuth": [] }, { "apiKeyHeader": [] } ], "parameters": [ { "name": "name", "in": "query", "required": false, "description": "精确型号，命中则返回单条 data 对象", "schema": { "type": "string" } }, { "name": "q", "in": "query", "required": false, "description": "模糊搜索关键字，如 400/50、LGJ", "schema": { "type": "string" } }, { "name": "page", "in": "query", "required": false, "description": "页码，从 1 开始", "schema": { "type": "integer", "default": 1 } }, { "name": "pageSize", "in": "query", "required": false, "description": "每页条数，最大 200", "schema": { "type": "integer", "default": 50 } } ], "responses": { "200": { "description": "查询成功", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "example": true }, "total": { "type": "integer" }, "page": { "type": "integer" }, "pageSize": { "type": "integer" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/Wire" } }, "request_id": { "type": "string" } } } } } }, "401": { "description": "缺少或无效的 API Key", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "密钥无该接口作用域（scope）", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "导线型号未找到", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "超出日配额", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/tldb/search": { "get": { "summary": "全局搜索（跨 10 个参数库）", "operationId": "searchTldb", "description": "跨导地线/气象区/绝缘子/金具/金具串/铁塔/接地/地脚螺栓/基础/物资编码共 10 个库，模糊匹配 name 字段。典型用途：拿到一个型号或代号（如塔型 V3-5D1W1-Z1-60、地脚螺栓 4M36×240）先不知道在哪个库时，一把搜出来。响应 data 每项带 db_key/db_name 标明命中库，fields 为该库完整字段。", "tags": [ "导线库" ], "security": [ { "bearerAuth": [] }, { "apiKeyHeader": [] } ], "parameters": [ { "name": "keyword", "in": "query", "required": true, "description": "搜索关键字，至少 2 个字符；% 和 _ 按普通文本处理", "schema": { "type": "string", "example": "4M36" } }, { "name": "db", "in": "query", "required": false, "description": "限定单库，可选值 wire/weather/insulator/fittings/fittings_assembly/tower/grounding/anchor_bolt/foundation/material_code", "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "description": "每个库最多返回条数，默认 10，最大 50", "schema": { "type": "integer", "default": 10, "maximum": 50 } } ], "responses": { "200": { "description": "搜索成功", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "example": true }, "keyword": { "type": "string" }, "db": { "type": "string", "description": "传入的 db 限定参数，未传时为 null" }, "per_lib_limit": { "type": "integer", "description": "每库返回条数上限" }, "matched_libs": { "type": "array", "description": "命中库摘要", "items": { "type": "object", "properties": { "db_key": { "type": "string" }, "db_name": { "type": "string" }, "count": { "type": "integer" } } } }, "total": { "type": "integer", "description": "命中条目总数" }, "data": { "type": "array", "items": { "type": "object", "properties": { "db_key": { "type": "string" }, "db_name": { "type": "string" }, "id": { "type": "integer" }, "fields": { "type": "object", "description": "该库完整字段（不含时间戳）" } } } }, "request_id": { "type": "string" } } } } } }, "400": { "description": "参数缺失/导线参数不完整", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "缺少或无效的 API Key", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "密钥无该接口作用域（scope）", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "超出日配额", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/huchui/calc": { "post": { "summary": "张力弧垂计算", "operationId": "calcSagTension", "description": "比载计算 → 控制气象判定（临界档距逻辑图法）→ 状态方程（弦截法）求应力/张力 → 弧垂。内置三套规范：old(DL/T 5092-1999) / new1(GB 50545-2010，默认) / new2(DL/T 5551-2018)。wire 可传型号字符串自动补全导线参数，也可传参数对象。", "tags": [ "张力弧垂" ], "security": [ { "bearerAuth": [] }, { "apiKeyHeader": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "wire", "conds" ], "properties": { "specId": { "type": "string", "enum": [ "old", "new1", "new2" ], "default": "new1" }, "wire": { "description": "导线：型号字符串（如 JL/G1A-400/50，自动补全）或参数对象", "oneOf": [ { "type": "string", "example": "JL/G1A-400/50" }, { "type": "object", "properties": { "xingHao": { "type": "string" }, "s": { "type": "number", "description": "截面 mm²" }, "D": { "type": "number", "description": "外径 mm" }, "W": { "type": "number", "description": "单重 kg/km" }, "E": { "type": "number", "description": "弹性模量 MPa" }, "alf": { "type": "number", "description": "线膨胀系数 1/℃" }, "Np": { "type": "number", "description": "额定拉断力 N" } } } ] }, "k1": { "type": "number", "default": 2.5, "description": "安全系数" }, "k2": { "type": "number", "default": 0.25, "description": "年平均运行应力百分数" }, "bzr": { "type": "number", "default": 0.95, "description": "保证率" }, "jT": { "type": "number", "default": 0, "description": "补偿初伸长降温 ℃（与 T 覆盖组合时按 T-jT 生效）" }, "avgHeight": { "type": "number", "default": 15, "description": "导线平均高度 m" }, "groundRoughness": { "type": "string", "enum": [ "A", "B", "C", "D" ], "default": "B" }, "conds": { "type": "array", "description": "气象工况；control 默认 1（参与控制）", "items": { "type": "object", "required": [ "name" ], "properties": { "name": { "type": "string", "example": "最大风速" }, "T": { "type": "number", "description": "温度 ℃" }, "V": { "type": "number", "description": "风速 m/s" }, "b": { "type": "number", "description": "冰厚 mm" }, "control": { "type": "integer", "enum": [ 0, 1 ], "default": 1 } } } }, "L": { "type": "number", "description": "档距 m（与 spans 二选一）" }, "spans": { "type": "array", "items": { "type": "number" }, "description": "多档距" }, "cond": { "type": "string", "description": "计算工况名（缺省取控制工况）" }, "T": { "type": "number", "description": "温度覆盖 ℃" } }, "example": { "specId": "new1", "wire": "JL/G1A-400/50", "conds": [ { "name": "最高气温", "T": 40, "V": 0, "b": 0 }, { "name": "最大风速", "T": -5, "V": 25, "b": 0 }, { "name": "最大覆冰", "T": -5, "V": 10, "b": 10 } ], "L": 400 } } } } }, "responses": { "200": { "description": "计算成功", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "example": true }, "specId": { "type": "string", "example": "new1" }, "spec": { "type": "string", "example": "GB 50545-2010" }, "L": { "type": "number", "description": "档距 m（单档距时）" }, "cond": { "type": "string", "description": "计算工况名" }, "control": { "type": "object", "description": "控制工况 {cond, sigmaMax}" }, "stress": { "type": "number", "description": "计算工况应力 N/mm²" }, "force": { "type": "number", "description": "张力 N" }, "sag": { "type": "number", "description": "弧垂 m" }, "conds": { "type": "array", "description": "各工况比载明细 g1~g7/gz/sigmaMax" }, "criticalSpans": { "type": "object", "description": "临界档距逻辑图 {\"1-2\": 186.7, ...}" }, "results": { "type": "array", "description": "spans 多档距时的逐档结果" }, "request_id": { "type": "string" } } } } } }, "400": { "description": "参数缺失/导线参数不完整", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "缺少或无效的 API Key", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "密钥无该接口作用域（scope）", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "超出日配额", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/cptool/cgcs2wgs": { "post": { "summary": "CGCS2000 投影坐标 → WGS84 经纬度", "operationId": "cgcs2wgs", "tags": [ "坐标处理" ], "description": "coords=[[x北(m), y东(m)],...]；y 带带号前缀（>1000000）时自动识别，否则需传 zone。", "security": [ { "bearerAuth": [] }, { "apiKeyHeader": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "coords" ], "properties": { "coords": { "type": "array", "description": "坐标对数组", "items": { "type": "array", "items": { "type": "number" } } }, "zone": { "type": "integer", "description": "3度带号" } }, "example": { "coords": [ [ 500000, 38500000 ] ], "zone": 38 } } } } }, "responses": { "200": { "description": "转换成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "400": { "description": "参数缺失/导线参数不完整", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "缺少或无效的 API Key", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "密钥无该接口作用域（scope）", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "超出日配额", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "502": { "description": "坐标服务暂不可用（coord_backend_unreachable）", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/cptool/wgs2cgcs": { "post": { "summary": "WGS84 经纬度 → CGCS2000 投影坐标", "operationId": "wgs2cgcs", "tags": [ "坐标处理" ], "description": "自动选覆盖点数最多的 3 度带（也可用 zone 指定），返回 deviation 长度变形偏差报告。", "security": [ { "bearerAuth": [] }, { "apiKeyHeader": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "coords" ], "properties": { "coords": { "type": "array", "description": "坐标对数组", "items": { "type": "array", "items": { "type": "number" } } }, "zone": { "type": "integer" } }, "example": { "coords": [ [ 114, 4.52 ] ], "zone": 38 } } } } }, "responses": { "200": { "description": "转换成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "400": { "description": "参数缺失/导线参数不完整", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "缺少或无效的 API Key", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "密钥无该接口作用域（scope）", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "超出日配额", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "502": { "description": "坐标服务暂不可用（coord_backend_unreachable）", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/cptool/batch": { "post": { "summary": "批量坐标转换", "operationId": "coordBatch", "tags": [ "坐标处理" ], "security": [ { "bearerAuth": [] }, { "apiKeyHeader": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "coords", "from_crs", "to_crs" ], "properties": { "coords": { "type": "array", "description": "坐标对数组", "items": { "type": "array", "items": { "type": "number" } } }, "from_crs": { "type": "string", "enum": [ "cgcs2000", "wgs84" ] }, "to_crs": { "type": "string", "enum": [ "cgcs2000", "wgs84" ] }, "zone": { "type": "integer" } } } } } }, "responses": { "200": { "description": "转换成功", "content": { "application/json": { "schema": { "type": "object" } } } }, "400": { "description": "参数缺失/导线参数不完整", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "缺少或无效的 API Key", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "密钥无该接口作用域（scope）", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "超出日配额", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "502": { "description": "坐标服务暂不可用（coord_backend_unreachable）", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/cptool/cgcs2shp": { "post": { "summary": "CGCS2000 坐标 → Shapefile ZIP", "operationId": "cgcs2shp", "tags": [ "坐标处理" ], "description": "生成点 + 折线两套 Shapefile（.shp/.shx/.dbf/.prj/.cpg）打包为 ZIP。", "security": [ { "bearerAuth": [] }, { "apiKeyHeader": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "coords", "zone" ], "properties": { "coords": { "type": "array", "description": "坐标对数组", "items": { "type": "array", "items": { "type": "number" } } }, "labels": { "type": "array", "items": { "type": "string" } }, "zone": { "type": "integer", "description": "3度带号（必填）" } } } } } }, "responses": { "200": { "description": "文件下载（cgcs2000_points_lines.zip）", "content": { "application/zip": { "schema": { "type": "string", "format": "binary" } } } }, "400": { "description": "参数缺失/导线参数不完整", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "缺少或无效的 API Key", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "密钥无该接口作用域（scope）", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "超出日配额", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/cptool/coord2pline": { "post": { "summary": "坐标 → DXF 多段线", "operationId": "coord2pline", "tags": [ "坐标处理" ], "security": [ { "bearerAuth": [] }, { "apiKeyHeader": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "sets" ], "properties": { "sets": { "type": "array", "items": { "type": "object", "properties": { "points": { "type": "array", "items": { "type": "object", "properties": { "label": { "type": "string" }, "x": { "type": "number" }, "y": { "type": "number" } } } } } } } } } } } }, "responses": { "200": { "description": "文件下载（coord2pline.dxf）", "content": { "application/dxf": { "schema": { "type": "string", "format": "binary" } } } }, "400": { "description": "参数缺失/导线参数不完整", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "缺少或无效的 API Key", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "密钥无该接口作用域（scope）", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "超出日配额", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/cptool/coord2dxf": { "post": { "summary": "坐标 → DXF（多段线+文字+塔块）", "operationId": "coord2dxf", "tags": [ "坐标处理" ], "description": "固定根开缩放；genkai 单位 m。", "security": [ { "bearerAuth": [] }, { "apiKeyHeader": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "sets", "genkai" ], "properties": { "sets": { "type": "array", "items": { "type": "object" } }, "genkai": { "type": "number", "description": "根开值 m" } } } } } }, "responses": { "200": { "description": "文件下载（coord2dxf.dxf）", "content": { "application/dxf": { "schema": { "type": "string", "format": "binary" } } } }, "400": { "description": "参数缺失/导线参数不完整", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "缺少或无效的 API Key", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "密钥无该接口作用域（scope）", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "超出日配额", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/cptool/coord2coverdxf": { "post": { "summary": "坐标 → 占地 DXF", "operationId": "coord2coverdxf", "tags": [ "坐标处理" ], "description": "每点独立根开缩放（points 每项需带 genkai）。", "security": [ { "bearerAuth": [] }, { "apiKeyHeader": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "sets" ], "properties": { "sets": { "type": "array", "items": { "type": "object" } } } } } } }, "responses": { "200": { "description": "文件下载（coord2coverdxf.dxf）", "content": { "application/dxf": { "schema": { "type": "string", "format": "binary" } } } }, "400": { "description": "参数缺失/导线参数不完整", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "缺少或无效的 API Key", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "密钥无该接口作用域（scope）", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "超出日配额", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/cptool/coverdxf2kml": { "post": { "summary": "占地几何 → KML", "operationId": "coverdxf2kml", "tags": [ "坐标处理" ], "description": "爆炸占地块 → 多边形/线/点 → WGS84 → KML。Y 坐标须含带号前缀（如 38500000）。", "security": [ { "bearerAuth": [] }, { "apiKeyHeader": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "sets" ], "properties": { "sets": { "type": "array", "items": { "type": "object" } } } } } } }, "responses": { "200": { "description": "文件下载（cover.kml）", "content": { "application/vnd.google-earth.kml+xml": { "schema": { "type": "string", "format": "binary" } } } }, "400": { "description": "参数缺失/导线参数不完整", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "缺少或无效的 API Key", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "密钥无该接口作用域（scope）", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "超出日配额", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/cptool/coverdxf2shp": { "post": { "summary": "占地几何 → Shapefile ZIP", "operationId": "coverdxf2shp", "tags": [ "坐标处理" ], "description": "面/线/点三套 Shapefile 打包 ZIP。Y 坐标须含带号前缀。", "security": [ { "bearerAuth": [] }, { "apiKeyHeader": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "sets" ], "properties": { "sets": { "type": "array", "items": { "type": "object" } } } } } } }, "responses": { "200": { "description": "文件下载（cover_shp.zip）", "content": { "application/zip": { "schema": { "type": "string", "format": "binary" } } } }, "400": { "description": "参数缺失/导线参数不完整", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "缺少或无效的 API Key", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "密钥无该接口作用域（scope）", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "超出日配额", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } } }, "components": { "securitySchemes": { "bearerAuth": { "type": "http", "scheme": "bearer", "description": "填入个人中心申请的 API Key（形如 sdgj_xxx），无需 bearer 前缀以外的加工" }, "apiKeyHeader": { "type": "apiKey", "in": "header", "name": "X-API-Key", "description": "备选鉴权头，与 Bearer 二选一" } }, "schemas": { "Error": { "type": "object", "properties": { "success": { "type": "boolean", "example": false }, "error": { "type": "string", "example": "wire_not_found" }, "message": { "type": "string" }, "request_id": { "type": "string" } } }, "Wire": { "type": "object", "description": "导线参数库记录（tldb_wire）", "properties": { "id": { "type": "integer" }, "name": { "type": "string", "example": "JL/G1A-400/50 (GB/T 1179-2017)" }, "d": { "type": "number", "description": "导线外径 mm" }, "S": { "type": "number", "description": "总截面 mm²" }, "S_Al": { "type": "number", "description": "铝截面 mm²" }, "n_Al": { "type": "integer", "description": "铝单线根数" }, "R20": { "type": "number", "description": "20℃直流电阻 Ω/km" }, "alpha": { "type": "number", "description": "电阻温度系数 1/℃" }, "S1": { "type": "number", "description": "钢芯外径 mm（计算时对应入参 dg）" }, "Np": { "type": "number", "description": "计算拉断力 N" }, "Npm": { "type": "number", "description": "额定拉断力 N" } } } } } }