设备列表

接口说明

获取当前账号有权限访问的设备列表，支持按设备类型、在线状态、所属公司等条件筛选，并可通过关键词搜索设备编号或名称。

请求信息

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

请求参数

以下参数均为查询参数（Query），全部可选。

参数名	类型	必填	说明
page	int	否	页码，默认 1
per_page	int	否	每页条数，默认 15
type_id	int	否	按设备类型 ID 筛选
keyword	string	否	按设备编号或名称搜索
online_status	int	否	在线状态：1 = 在线，0 = 离线
company_id	int	否	按所属公司 ID 筛选

请求示例

curl -X GET "https://devapi.fengshengshou.com/api/devices?page=1&per_page=15&online_status=1" \
  -H "Authorization: Bearer your_token_here" \
  -H "Accept: application/json"

响应参数

字段	类型	说明
code	int	状态码，0 表示成功
message	string	响应描述
data.items	array	设备对象数组
data.items[].id	int	设备 ID
data.items[].device_no	string	设备编号
data.items[].name	string	设备名称
data.items[].type_id	int	设备类型 ID
data.items[].type_name	string	设备类型名称
data.items[].type_code	string	设备类型代码
data.items[].model	string	设备型号
data.items[].online_status	int	在线状态：1 = 在线，0 = 离线
data.items[].running_status	int	运行状态码
data.items[].is_online	bool	是否在线
data.items[].is_online_text	string	在线状态文字描述
data.items[].location	string	设备位置描述
data.items[].last_online_at	string	最近上线时间
data.pagination	object	分页信息
data.pagination.current_page	int	当前页码
data.pagination.per_page	int	每页条数
data.pagination.total	int	总记录数
data.pagination.total_pages	int	总页数

成功响应

{
  "code": 0,
  "message": "success",
  "data": {
    "items": [
      {
        "id": 101,
        "device_no": "DEV-2024-001",
        "name": "1号巡检机器人",
        "type_id": 3,
        "type_name": "巡检机器人",
        "type_code": "inspection_robot",
        "model": "IR-X200",
        "online_status": 1,
        "running_status": 1,
        "is_online": true,
        "is_online_text": "在线",
        "location": "A区变电站",
        "last_online_at": "2026-07-05 10:23:45"
      }
    ],
    "pagination": {
      "current_page": 1,
      "per_page": 15,
      "total": 42,
      "total_pages": 3
    }
  }
}

失败响应

{
  "code": 401,
  "message": "未授权，请先登录",
  "data": null
}