海康工业相机HTTP API服务

通过FastAPI提供HTTP接口控制海康工业相机拍照

功能特性

• ✅ 支持多相机管理
• ✅ 通过IP地址、序列号、索引选择相机
• ✅ RESTful API接口
• ✅ 自动图像格式转换（BMP/JPG）
• ✅ 图片下载接口
• ✅ 完整的错误处理

安装依赖

pip install -r requirements.txt

启动服务

python camera_api.py

服务将在 http://localhost:8000 启动

API文档

启动服务后访问：
- Swagger UI: http://localhost:8000/docs
- ReDoc: http://localhost:8000/redoc

API接口

1. 列出所有相机

GET /cameras

响应示例：
json { "success": true, "count": 2, "cameras": [ { "index": 0, "type": "GigE", "model": "MV-CS200-10GC", "serial": "00J12345678", "ip": "192.168.1.100", "user_defined_name": "Camera1" } ] }

2. 拍照（通过IP地址）

GET /capture?ip=192.168.1.100&filename=test_image

POST /capture
json { "ip": "192.168.1.100", "filename": "test_image", "save_bmp": true, "save_jpg": true, "timeout": 3000 }

响应示例：
json { "success": true, "message": "拍照成功", "files": ["test_image.bmp", "test_image.jpg"], "camera_info": { "type": "GigE", "model": "MV-CS200-10GC", "serial": "00J12345678", "ip": "192.168.1.100" } }

3. 拍照（通过序列号）

GET /capture_by_serial?serial=00J12345678&filename=test_image

4. 拍照（通过索引）

GET /capture_by_index?index=0&filename=test_image

5. 下载图片

GET /image/test_image.jpg

6. 健康检查

GET /health

使用示例

Python客户端

import requests

# 列出所有相机
response = requests.get("http://localhost:8000/cameras")
cameras = response.json()["cameras"]

# 通过IP地址拍照
response = requests.get(
    "http://localhost:8000/capture",
    params={
        "ip": "192.168.1.100",
        "filename": "my_image"
    }
)
result = response.json()
print(f"保存的文件: {result['files']}")

# 下载图片
response = requests.get("http://localhost:8000/image/my_image.jpg")
with open("downloaded.jpg", "wb") as f:
    f.write(response.content)

cURL

# 列出相机
curl http://localhost:8000/cameras

# 拍照（GET）
curl "http://localhost:8000/capture?ip=192.168.1.100&filename=test_image"

# 拍照（POST）
curl -X POST http://localhost:8000/capture \
  -H "Content-Type: application/json" \
  -d '{"ip":"192.168.1.100","filename":"test_image"}'

# 下载图片
curl -O http://localhost:8000/image/test_image.jpg

JavaScript/Fetch

// 列出相机
fetch('http://localhost:8000/cameras')
  .then(res => res.json())
  .then(data => console.log(data));

// 拍照
fetch('http://localhost:8000/capture?ip=192.168.1.100&filename=test_image')
  .then(res => res.json())
  .then(data => console.log(data));

// 下载图片
fetch('http://localhost:8000/image/test_image.jpg')
  .then(res => res.blob())
  .then(blob => {
    const url = window.URL.createObjectURL(blob);
    const a = document.createElement('a');
    a.href = url;
    a.download = 'test_image.jpg';
    a.click();
  });

测试

运行测试客户端：

python test_api.py

文件说明

• camera_api.py - FastAPI服务主文件
• camera_manager.py - 相机管理类
• test_api.py - API测试客户端
• test.py - 基础测试脚本
• example_multi_camera.py - 多相机使用示例
• requirements.txt - Python依赖

注意事项

1. 确保相机已正确连接并配置好网络
2. 关闭海康MVS客户端软件，避免设备占用
3. 图片默认保存在当前目录
4. 建议在生产环境中添加认证和权限控制
5. 可以通过环境变量配置服务端口和保存路径

故障排除

错误：设备无访问权限 (0x80000203)

• 关闭海康MVS客户端
• 确保没有其他程序占用相机

错误：获取图像失败 (0x80000007)

• 检查相机镜头盖是否打开
• 确保有足够光线
• 增加timeout参数值

错误：无法连接到API服务

• 确保服务已启动：python camera_api.py
• 检查端口8000是否被占用