📚 开放 API 接口文档

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

这是什么

本站开放 API 让你(或你的 AI 助手、脚本)通过一枚 API Key 直接调用输电专业计算与数据能力, 例如「已知导线型号和环境条件,求允许载流量」「查询某型号导线的全部参数」「把一批 CGCS2000 坐标转成经纬度」。

接口采用 REST 风格,全部返回 UTF-8 JSON,GET 与 POST 等价, 并且提供自描述能力清单——AI 只需先请求一次 GET /openapi/v1,就能发现当前所有可用接口及其参数。

还没有 Key? 登录后到 个人中心 → 开放API密钥 申请,明文只显示一次,请立即保存。 机器可读的规范文件:OpenAPI 3.0 规范(可导入 Postman / ChatGPT Actions / Dify / Coze)。

能力总览

接口路径作用域状态
能力清单GET /openapi/v1—已上线
导线载流量计算GET|POST /openapi/v1/zlljs/calczlljs:calc已上线
导线参数库查询GET /openapi/v1/tldb/wiretldb:read已上线
全局搜索(跨 10 库)GET /openapi/v1/tldb/searchtldb:read已上线
张力弧垂计算GET|POST /openapi/v1/huchui/calchuchui:calc已上线
坐标转换(投影互转)POST /openapi/v1/cptool/cgcs2wgs 等 3 个cptool:coord已上线
坐标 → CAD/GIS 文件POST /openapi/v1/cptool/coord2dxf 等 6 个cptool:cad已上线

快速入口

三条最重要的规则

  • 每个请求都要带 Key:Authorization: Bearer sdgj_xxxx…(详见 鉴权)。
  • 参数放 query 还是 JSON body 都行,服务端自动合并(详见 请求规则)。
  • 失败时响应里有 error 码和 message,按提示修正即可(详见 错误码)。
就绪 塔基: 0 粤公网安备44060502004295号 粤ICP备2026039854号-1