铝材工件智能计数系统 API

在线 API 文档与调试平台 - 支持16个接口的实时测试和监控

接口列表

系统

1 个接口
GET
健康检查
检查系统是否正常运行，用于监控和负载均衡
/health

核心功能

2 个接口
POST
工件识别 - Base64版本
上传Base64格式的工件图片和物料草图，进行AI识别并返回统计结果
/api/process_image
POST
⭐ 推荐
工件识别 - 文件上传版本 ⭐推荐
直接上传图片文件进行识别，无需Base64转换（推荐前端使用）
/api/process_image_file

批次管理

5 个接口
POST
保存物料信息 - Base64版本
保存批次号和物料信息到数据库（Base64格式，草图可选）
/api/save_materials
POST
⭐ 推荐
保存物料信息 - 文件上传版本 ⭐推荐
直接上传草图文件保存物料信息（草图可选，推荐使用）
/api/save_materials_with_files
GET
查询批次信息
根据批次号查询物料详情和识别结果
/api/get_materials/{documentNumber}
GET
获取批次列表
获取所有批次列表，支持分页和状态筛选
/api/documents
GET
获取统计数据
获取系统整体统计数据（用于仪表板展示）
/api/statistics

摄像头

8 个接口
POST
摄像头抓拍并识别
从海康威视摄像头抓拍图片，并可选择自动进行工件识别
/api/capture_camera
GET
获取摄像头列表
获取所有摄像头设备列表，支持分页和状态筛选
/api/cameras
POST
添加摄像头设备
添加新的摄像头设备到系统
/api/cameras
GET
获取摄像头详情
获取指定摄像头的详细信息
/api/cameras/{cameraId}
PUT
更新摄像头配置
更新摄像头设备配置（支持部分字段更新）
/api/cameras/{cameraId}
DELETE
删除摄像头设备
删除指定的摄像头设备
/api/cameras/{cameraId}
POST
测试摄像头连接
测试摄像头连接状态（不保存设备信息）
/api/cameras/test
POST
摄像头预览抓拍
从指定摄像头抓拍预览图（返回Base64，不保存文件）
/api/cameras/{cameraId}/preview
在线测试
直接在浏览器中测试所有 API 接口，支持文件上传和 Base64 编码
实时监控
查看 API 调用统计、成功率、响应时间等关键指标
完整文档
详细的接口说明、参数定义、响应示例和错误处理