洲明 GTM 开发者平台与 API 文档
信号与电源走线、发送卡选型、CAD/PDF 工程图纸和 CPQ 集成接口。
核心设计与走线 API (Core APIs)
针对 LED 大屏的发送卡选型计算、电源进线计算与信号电源全流程生成。
-
POST /api/calculate_sending_card
— 发送卡选型与信号走线计算
输入屏幕尺寸、分辨率与箱体信息，自动分配信号走线网口回路、匹配最优发送卡/拼控机箱及板卡组合，并返回 Top-3 候选推荐方案与线缆 BOM。
-
POST /api/calculate_power_wiring
— 纯电源走线图与进线回路计算
输入屏幕尺寸、总功率、实际电流与电压，计算电源进线与过箱线并生成图纸。product_name、country、installation_country、cable_certification 均可省略；只传几何参数时 actual_current 必须为正数。示例为 5×5 箱体、120V，无产品名/国家/线材认证；功率与电流仅为示例假设，须替换为项目核实值。显式电压和线材认证优先于国家默认；不从电压或产品认证反推国家。非空未知/歧义国家必须同时提供有效线材认证和正电压；否则或认证/电压无效时返回 HTTP 400 invalid_wiring_context。响应 wiring_context 包含 country_status、cable_source/voltage_source（explicit/country/legacy）；compatibility_warnings 说明兼容性限制，material_gaps 说明物料缺失。success 不代表国家适用性或物料认证已核验。
-
POST /run_signal_wiring
— 全功能信号与电源联合走线及 CAD/PDF 全套图纸生成 (All-in-One)
表单接口（不接受 JSON body；字段名为复数，对象/数组须为 JSON 字符串，布尔值为 'true'/'false'）。需要电源结果时传 config_type=signal_and_power。系统核心计算引擎接口。一次性完成信号走线回路、电源进线与过箱线计算、4K分块拼控、控制器选型，并联合生成全套高清走线图 (images)、AutoCAD DXF 矢量工程图纸 (cad_files) 与工程级矢量 PDF 打印图纸 (cad_pdf_files)。signal_and_power 模式下国家和线材认证可省略；无国家且未传电压时使用 220V。非法认证/电压或未补齐手动参数的未知国家返回 HTTP 400 invalid_wiring_context。响应 wiring_contexts 按屏提供解析来源，compatibility_warnings 与 material_gaps 须用于交付复核，success 不证明国家适用性或物料认证。
CPQ 对外集成 API (CPQ APIs)
专为 CPQ / ERP / CRM 报价系统设计的解耦式信号走线图、发送卡选型与配置字典接口。
-
POST /api/cpq/signal_diagram
— CPQ 纯信号走线图生成 (无需发送卡)
轻量级纯信号走线接口，不依赖发送卡选型库，快速返回网线数量、过箱线与 PNG 走线图。
-
POST /api/cpq/calculate_sending_card
— CPQ 发送卡选型计算与板卡清单
专为报价系统设计的发送卡推荐接口，返回主控机箱与输入/输出/选配板卡的结构化清单 (cardList) 及 Top-3 方案。
-
GET /api/cpq/metadata
— 一次获取 CPQ 可选值（品牌、卡类型、插头标准、区域）
构造选型请求前先调用：返回可用品牌（含中英文名）、同步/异步卡类型、插头标准与业务区域。
-
GET /api/cpq/brands
— 获取 CPQ 可用发送卡品牌列表
查询当前系统支持的发送卡品牌清单。
-
GET /api/cpq/available_cards
— 查询可用发送卡库清单
支持按品牌、区域、同步/异步筛选发送卡库。
-
GET /api/cpq/plug_standards
— 查询支持的电源插头标准
获取可选的电源线插头规格列表（如国标、美标、欧标、英标）。