设备列表查询（分页）

请求参数

Authorization

在 header 添加参数

Authorization

示例：

Authorization: ********************

Body 参数application/json

page

object

分页参数

必需

current

integer

现页数

必需

size

integer

每页个数

必需

query

object

请求参数

必需

search_value

string

综合模糊查询字段

可选

可传入设备sn、设备项目名、设备项目id综合模糊查询

status

integer

设备状态

可选

0-未激活；1-在线；2-离线；3-故障全匹配

device_type

integer

设备类型

可选

1-直连设备；2-网关设备；3-网关子设备全匹配

product_id

string

产品id

可选

全匹配

device_id

string

设备id

可选

全匹配

project_id

string

项目id

可选

全匹配

示例

{
    "page": {
        "current": 0,
        "size": 10
    },
    "query": {
        "search_value": "",
        "status": 0,
        "device_type": 1,
        "product_id": "f6dd5c6fbc2aca78d48f14b1",
        "device_id": "f6dd5c6fbc2aca78d48f14b1_k3sdevicesn",
        "project_id": ""
    }
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'http://10.110.17.16:53000/manager/device/queryPageByParams' \
--header 'Content-Type: application/json' \
--header 'Authorization;' \
--data-raw '{
    "page": {
        "current": 0,
        "size": 10
    },
    "query": {
        "search_value": "",
        "status": 0,
        "device_type": 1,
        "product_id": "f6dd5c6fbc2aca78d48f14b1",
        "device_id": "f6dd5c6fbc2aca78d48f14b1_k3sdevicesn",
        "project_id": ""
    }
}'

返回响应

🟢200成功

application/json

Body

timestamp

string

时间戳

必需

status

integer

状态

必需

message

string

处理结果信息

必需

data

object

处理返回数据

必需

total

string

结果总数

必需

list

array [object {12}]

结果列表

可选

size

integer

每页数量

必需

示例

{
    "timestamp": "2025-05-19 16:56:45",
    "status": 200,
    "message": "请求处理成功!",
    "data": {
        "total": "2",
        "list": [
            {
                "device_id": "61449393e28e8a027d579406_SLF8852515154",
                "status": 0,
                "description": "设备名称",
                "device_sn": "SLF8852515154",
                "product_name": "K3S-大门终端（物业云直连设备）",
                "product_id": "61449393e28e8a027d579406",
                "product_code": "K3S",
                "product_code_id": "3T41K3S01",
                "device_type": 1,
                "is_ext_unbind": true,
                "create_time": "2025-05-15 10:30:56",
                "mac_addr": "1SAD87U21"
            },
            {
                "device_id": "61449393e28e8a027d579406_SLF885285",
                "status": 0,
                "description": "设备名称",
                "device_sn": "SLF885285",
                "product_name": "K3S-大门终端（物业云直连设备）",
                "product_id": "61449393e28e8a027d579406",
                "product_code": "K3S",
                "product_code_id": "3T41K3S01",
                "device_type": 1,
                "project_id": "1000006594",
                "is_ext_unbind": true,
                "create_time": "2025-05-12 13:53:42"
            }
        ],
        "page_num": 1,
        "page_size": 10,
        "size": 2,
        "start_row": "1",
        "end_row": "2",
        "pages": 1,
        "pre_page": 0,
        "next_page": 0,
        "is_first_page": true,
        "is_last_page": true,
        "has_previous_page": false,
        "has_next_page": false,
        "navigate_pages": 10,
        "navigatepage_nums": [
            1
        ],
        "navigate_first_page": 1,
        "navigate_last_page": 1
    }
}