AOI 接口文档

基本信息

• 基础路径：/api/SpiAoi（示例完整地址：http://192.168.1.251:10054/api/SpiAoi）
• 请求与响应格式：application/json; charset=utf-8

统一返回模型（ResponseResult）

• status：整数，0 表示成功，1 表示失败
• message：字符串，返回说明或错误信息
• data：对象，业务数据载体
• TotalCount：整数，仅分页接口使用，表示总记录数

Aoi数据说明

设备与产线：
- machineName：字符串，可空。检测机台名称。
- lineDisplayName：字符串，可空。产线显示名称。

缺陷计数（均为整数，必须 ≥0）：
- offsetCount：偏位数量（器件贴装偏移）。
- missingCount：缺件数量（器件缺失）。
- reverseCount：反向数量（器件极性/方向反装）。
- liftedCount：翘起数量（器件一端或整体翘起）。
- floatHighCount：浮高数量（器件高度超差）。
- tombstoneCount：立碑数量（片式器件一端竖起）。
- flipCount：翻转数量（器件翻面/翻身）。
- wrongPartCount：错件数量（型号/规格错误）。
- leadLiftCount：翘脚数量（引脚未贴伏）。
- coldJointCount：虚焊数量（冷焊/假焊）。
- noSolderCount：空焊数量（焊料缺失）。
- insufficientSolderCount：少锡数量（焊料不足）。
- excessSolderCount：多锡数量（焊料过量）。
- bridgeCount：连锡数量（焊锡桥连）。
- copperExposureCount：漏铜数量（焊盘/线路铜箔外露）。
- spikeCount：拉尖数量（锡料拉尖）。
- foreignMatterCount：异物数量（污染/颗粒）。
- glueOverflowCount：溢胶数量（胶水外溢）。
- pinOffsetCount：引脚偏位数量（引脚未对中）。

产线统计（除比率外为整数，必须 ≥0）：
- inputBoards：投入板数（进入检测的板数量）。
- okBoards：OK 板数（检测为 OK 的板数量）。
- passBoards：通过板数（最终判定通过的板数量）。
- passRate：小数，单位百分比。合格率，例如 98.00 表示 98%。
- defectBoards：不良板数（最终判定不良的板数量）。
- defectRate：小数，单位百分比。不良率。
- defectPpm：整数，单位 PPM。不良数（百万分率）。
- defectPoints：不良点数（缺陷点合计）。
- measuredPoints：实测点数（实际完成检测的点数）。
- pendingPoints：待测点数（未完成检测的点数）。

返回字段示例：
- headerId：数据库生成的 ID
- createdAt：创建时间

- updatedAt：更新时间

接口列表

以下两个接口覆盖单笔与批量入库场景，均使用 POST。

1. UploadAoiHeader — 上传 AOI Header（单笔）

• 路径：POST /api/SpiAoi/UploadAoiHeader
• 描述：插入一条 AOI Header 记录，条码重复时返回错误。
• 请求示例
  json { "testDate": "2025-10-10", "testTime": "14:33:21", "testResult": "0;0;0:1", "surface": "T", "totalPoints": 500, "actualDefects": 3, "equipmentModel": "SPI-9000", "workOrder": "WO20251010-01", "productModel": "MODEL-ABC", "boardBarcode": "BC123456789", "smtGroup": "A1", "lineName": "SMT-01" }
• 成功响应
  json { "status": 0, "message": "OK", "data": { "headerId": 12001, "message": "AOI header upload succeeded" }, "TotalCount": 0 }

2. UploadAoiHeaderBatch — 批量上传 AOI Header

• 路径：POST /api/SpiAoi/UploadAoiHeaderBatch
• 描述：一次插入多条 Header 记录；若任何一条校验或插入失败，整批回滚。
• 请求示例
  json [ { "testDate": "2025-10-10", "testTime": "14:33:21", "testResult": "0;0;0:1", "surface": "T", "boardBarcode": "BC123456789" }, { "testDate": "2025-10-10", "testTime": "14:34:00", "testResult": "0;0;0:1", "surface": "B", "boardBarcode": "BC123456790" } ]
• 成功响应
  json { "status": 0, "message": "OK", "data": { "headerIds": [12001, 12002], "message": "AOI header batch upload succeeded" }, "TotalCount": 0 }

调用建议

• 严格按照字段类型与长度构造数据；数值类字段建议使用整型或保留合适小数位。
• 出现错误时先查看 message，再结合消息中心记录和服务端日志定位问题。
• 建议在批量调用前自行去重条码或关键字段，减少回滚概率。