跳转至

订单管理 API

所有端点以 /api/v1/devices/{device_id} 为前缀。


GET /api/v1/devices/{device_id}/orders

获取贴装工单列表。

响应

{
  "success": true,
  "orders": [
    {
      "id": "order_001",
      "status": "pending",
      "created_at": 1721788800,
      "items": []
    }
  ]
}

GET /api/v1/devices/{device_id}/orders/recent

获取最近处理的贴装工单。

响应

{
  "success": true,
  "orders": [ "最近工单" ]
}

GET /api/v1/devices/{device_id}/orders/{oid}

获取指定工单的详细信息。

响应

{
  "success": true,
  "order": { "工单详情" }
}

POST /api/v1/devices/{device_id}/orders

创建新的贴装工单。

请求

{
  "name": "测试订单",
  "items": [
    {
      "component": "R0402-10K",
      "x": 10.0,
      "y": 20.0,
      "angle": 0.0
    }
  ],
  "settings": {}
}

响应

{
  "success": true,
  "order": { "创建的工单信息" }
}

POST /api/v1/devices/{device_id}/orders/parse

解析贴装订单文件(如 Gerber/CSV 等格式)。

请求

{
  "filename": "order.csv",
  "encoding": "base64",
  "data": "base64编码的文件内容"
}

响应

{
  "success": true,
  "parsed": { "解析后的订单数据" }
}

POST /api/v1/devices/{device_id}/orders/{oid}/cancel

取消指定的贴装工单。

响应

{
  "success": true,
  "status": 200,
  "data": { "取消结果" }
}

DELETE /api/v1/devices/{device_id}/orders/{oid}

删除指定的贴装工单。

响应

{
  "success": true,
  "status": 200,
  "data": { "删除结果" }
}