设备控制

接口说明

向指定设备发送控制指令。发送前请通过设备详情接口确认设备处于在线状态，并从 commands 字段获取该设备支持的指令列表。

请求信息

项目	内容
方法	POST
URL	https://devapi.fengshengshou.com/api/devices/{id}/command
鉴权	是，请求头携带 Authorization: Bearer your_token_here

请求参数

路径参数：

参数名	类型	必填	说明
id	int	是	设备 ID

请求体（JSON）：

参数名	类型	必填	说明
command	string	是	指令代码，须为该设备类型支持的合法指令
params	object	否	指令参数键值对，无额外参数时可省略

请求示例

curl -X POST "https://devapi.fengshengshou.com/api/devices/101/command" \
  -H "Authorization: Bearer your_token_here" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "command": "start_patrol",
    "params": {
      "speed": 1.0,
      "route_id": 5
    }
  }'

响应参数

字段	类型	说明
code	int	状态码，0 表示成功
message	string	响应描述
data.command_id	string	本次指令的唯一 ID
data.device_id	int	目标设备 ID
data.device_no	string	目标设备编号
data.command_code	string	指令代码
data.command_name	string	指令名称
data.success	bool	指令是否发送成功
data.status	string	指令状态：sent 已发送，failed 发送失败
data.message	string|null	附加说明，可为空
data.params	object	实际下发的指令参数
data.sent_at	string	指令发送时间

成功响应

{
  "code": 0,
  "message": "success",
  "data": {
    "command_id": "cmd-20260705-0001",
    "device_id": 101,
    "device_no": "DEV-2024-001",
    "command_code": "start_patrol",
    "command_name": "开始巡检",
    "success": true,
    "status": "sent",
    "message": null,
    "params": {
      "speed": 1.0,
      "route_id": 5
    },
    "sent_at": "2026-07-05 10:30:00"
  }
}

失败响应

{
  "code": 404,
  "message": "设备不存在",
  "data": null
}

{
  "code": 30004,
  "message": "无设备控制权限",
  "data": null
}

{
  "code": 30002,
  "message": "设备已离线",
  "data": null
}

{
  "code": 30005,
  "message": "指令不存在",
  "data": null
}

{
  "code": 30006,
  "message": "不支持的设备类型",
  "data": null
}