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;失败保留原始错误码与失败层信息,支持重试一次。

