下载中心/接口清单

接口清单

下载原文件

P20 在线 DFM 预审 接口清单(规划)

> 前缀:/api/dfm 鉴权:检查接口需登录或按设备额度限流;报告下载需归属校验

1. 任务

方法路径说明主要参数
POST/tasks创建检查任务file_ids[] supplier_id stackup surface_finish
GET/tasks我的任务列表page size status
GET/tasks/{id}任务详情与摘要id
GET/tasks/{id}/risks风险清单level layer page
GET/tasks/{id}/report下载报告format=pdf

2. 分层与预览

方法路径说明
GET/tasks/{id}/layers分层清单与边界框
GET/tasks/{id}/layer/{layerId}单层渲染数据(分块坐标)
GET/tasks/{id}/measure测量接口(两点距离 / 角度)

3. 规则与供应商能力

方法路径说明
GET/rules规则族与默认阈值
GET/suppliers/{id}/rules工厂工艺能力
POST/suppliers/{id}/rules保存工艺能力(需供应商身份)
GET/suppliers/{id}/reports客户共享的 DFM 报告

4. 额度

方法路径说明
GET/quota当日剩余次数与文件大小上限

5. 关键字段

dfm_task:task_sn user_id supplier_id rfq_id file_type layer_count stackup surface_finish status yield_min yield_max risk_red risk_yellow risk_blue report_url

dfm_risk:task_id rule_code level title detail layer pos_x pos_y suggest

dfm_supplier_rule:supplier_id rule_code min_val max_val unit enabled

6. 错误码

码含义处理
21001文件格式不支持提示支持 Gerber RS274X / Excellon,ODB++ 需后端服务
21002分层缺失或重名列出缺失层并允许手动映射后重试
21003文件超出大小上限提示压缩或拆分上传
21004当日额度已用完提示次日或按会员额度
21005工厂能力未维护回退平台通用规则并在报告注明
21006报告不存在或已过期提示重新生成

7. 状态机

queued → parsing → checking → done / failed;失败保留原始错误码与失败层信息,支持重试一次。