下载中心/接口清单

接口清单

下载原文件

P22 拼板 / V-CUT / 邮票孔 接口清单

> 说明:路径为平台内规划路径,前端经现有数据层访问;仅在平台数据库开启后可用,未开启时回退本机演示数据。

1. 拼板任务

方法路径说明
POST/panel/tasks创建拼板任务,返回 task_id 与计算结果
GET/panel/tasks?user_id=我的拼板任务列表
GET/panel/tasks/{id}任务详情(参数、结果、风险项)
PATCH/panel/tasks/{id}更新参数并重算
DELETE/panel/tasks/{id}删除任务
POST/panel/tasks/{id}/to-rfq方案带入询价单
POST/panel/tasks/{id}/to-dfm方案带入 DFM 预审

2. 计算

方法路径说明
POST/panel/compute入参单板尺寸、工艺边、板间距、阵列、基板尺寸,返回拼板尺寸、单板数、利用率
POST/panel/vcut/check校验 V-CUT 角度、残留厚度、交叉跳刀
POST/panel/stamp/check校验邮票孔孔径、孔距、连接筋宽度、桥连数量

3. 模板

方法路径说明
GET`/panel/templates?scope=public\mine\team`模板列表
POST/panel/templates保存模板
DELETE/panel/templates/{id}删除模板

4. 供应商参数

方法路径说明
GET/panel/supplier-params?supplier_id=读取工厂拼板能力
PUT/panel/supplier-params/{supplier_id}维护参数(仅该供应商账号)

5. 数据字段

panel_task:id user_id board_len board_wid board_thk edge_rail gap rotate rows cols panel_len panel_wid pcs_count utilization split_mode vcut_json stamp_json status created_at

panel_risk:task_id code level title detail suggest

panel_supplier_param:supplier_id board_max_len board_max_wid vcut_min_residual vcut_angle stamp_hole_min stamp_hole_max stamp_pitch_min stamp_pitch_max bridge_min enabled

6. 错误码

码含义处理
22001单板尺寸缺失或非法提示必须为正数,单位 mm
22002阵列数为 0按基板尺寸给出建议行列数
22003拼板超出基板尺寸提示减少行列或缩小工艺边
22004V-CUT 残留厚度低于工厂下限提示建议值与来源
22005邮票孔参数越界标黄并给出可用区间
22006无工厂参数回退平台通用缺省值并在报告中注明

7. 状态机

draft → computed → sent_to_rfq / sent_to_dfm → archived;参数变更后回到 draft 重算。