获取设备列表

POST

/api/v1/things/device/info/get-list

请求参数

Header 参数

Body 参数application/json

示例

{
    "page": {
        "page": 0,
        "size": 0,
        "orders": [
            {
                "field": "string",
                "sort": 0
            }
        ]
    },
    "tenantCode": "string",
    "productID": "string",
    "productIDs": [
        "string"
    ],
    "deviceName": "string",
    "deviceNames": [
        "string"
    ],
    "deviceNameOrAlias": "string",
    "expTime": {
        "cmpType": "string",
        "value": "string"
    },
    "ratedPower": {
        "cmpType": "string",
        "value": "string"
    },
    "rssi": {
        "cmpType": "string",
        "value": "string"
    },
    "deviceAlias": "string",
    "deviceTypes": [
        0
    ],
    "position": {
        "longitude": 180,
        "latitude": 90
    },
    "range": 0,
    "tags": [
        {
            "key": "string",
            "value": "string"
        }
    ],
    "withProperties": [
        "string"
    ],
    "propertyIgnoreEmpty": true,
    "withProfiles": [
        "string"
    ],
    "areaID": "string",
    "areaIDs": [
        "string"
    ],
    "areaIDPath": "string",
    "areaIDPaths": [
        "string"
    ],
    "isOnline": 2,
    "productCategoryID": 0,
    "productCategoryIDs": [
        0
    ],
    "withShared": 2,
    "withCollect": 2,
    "versions": [
        "string"
    ],
    "notVersion": "string",
    "gateway": {
        "productID": "string",
        "productName": "string",
        "deviceName": "string"
    },
    "groupID": "string",
    "groupIDs": [
        "string"
    ],
    "groupIDPaths": [
        "string"
    ],
    "groupIDPath": "string",
    "notGroupID": "string",
    "parentGroupID": "string",
    "groupPurpose": "string",
    "groupName": "string",
    "notAreaID": "string",
    "devices": [
        {
            "productID": "string",
            "productName": "string",
            "deviceName": "string"
        }
    ],
    "status": 0,
    "statuses": [
        0
    ],
    "withOwner": true,
    "withGateway": true,
    "hasOwner": 0,
    "userID": "string",
    "netType": 8,
    "withArea": true,
    "isOnlyCore": true,
    "iccid": "string",
    "withGroups": [
        "string"
    ],
    "property": {}
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/api/v1/things/device/info/get-list' \
--header 'Ithings-Project-Id: {{Ithings-Project-Id}}' \
--header 'Ithings-Token: {{iThings-token}}' \
--header 'app-code: {{appCode}}' \
--header 'device-id;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "page": {
        "page": 0,
        "size": 0,
        "orders": [
            {
                "field": "string",
                "sort": 0
            }
        ]
    },
    "tenantCode": "string",
    "productID": "string",
    "productIDs": [
        "string"
    ],
    "deviceName": "string",
    "deviceNames": [
        "string"
    ],
    "deviceNameOrAlias": "string",
    "expTime": {
        "cmpType": "string",
        "value": "string"
    },
    "ratedPower": {
        "cmpType": "string",
        "value": "string"
    },
    "rssi": {
        "cmpType": "string",
        "value": "string"
    },
    "deviceAlias": "string",
    "deviceTypes": [
        0
    ],
    "position": {
        "longitude": 180,
        "latitude": 90
    },
    "range": 0,
    "tags": [
        {
            "key": "string",
            "value": "string"
        }
    ],
    "withProperties": [
        "string"
    ],
    "propertyIgnoreEmpty": true,
    "withProfiles": [
        "string"
    ],
    "areaID": "string",
    "areaIDs": [
        "string"
    ],
    "areaIDPath": "string",
    "areaIDPaths": [
        "string"
    ],
    "isOnline": 2,
    "productCategoryID": 0,
    "productCategoryIDs": [
        0
    ],
    "withShared": 2,
    "withCollect": 2,
    "versions": [
        "string"
    ],
    "notVersion": "string",
    "gateway": {
        "productID": "string",
        "productName": "string",
        "deviceName": "string"
    },
    "groupID": "string",
    "groupIDs": [
        "string"
    ],
    "groupIDPaths": [
        "string"
    ],
    "groupIDPath": "string",
    "notGroupID": "string",
    "parentGroupID": "string",
    "groupPurpose": "string",
    "groupName": "string",
    "notAreaID": "string",
    "devices": [
        {
            "productID": "string",
            "productName": "string",
            "deviceName": "string"
        }
    ],
    "status": 0,
    "statuses": [
        0
    ],
    "withOwner": true,
    "withGateway": true,
    "hasOwner": 0,
    "userID": "string",
    "netType": 8,
    "withArea": true,
    "isOnlyCore": true,
    "iccid": "string",
    "withGroups": [
        "string"
    ],
    "property": {}
}'

返回响应

🟢200成功

application/json

A successful response.

Body

示例

{
    "code": "200",
    "msg": "string",
    "data": {
        "list": [
            {
                "id": 0,
                "tenantCode": "string",
                "productID": "string",
                "projectID": "string",
                "productName": "string",
                "deviceType": 0,
                "productImg": "string",
                "areaID": "string",
                "deviceName": "string",
                "deviceAlias": "string",
                "secret": "string",
                "cert": "string",
                "imei": "string",
                "mac": "string",
                "categoryID": 0,
                "version": "string",
                "hardInfo": "string",
                "softInfo": "string",
                "mobileOperator": 10,
                "phone": "string",
                "iccid": "string",
                "position": {
                    "longitude": 180,
                    "latitude": 90
                },
                "address": "string",
                "adcode": "string",
                "tags": [
                    {
                        "key": "string",
                        "value": "string"
                    }
                ],
                "schemaAlias": {},
                "isOnline": 2,
                "firstLogin": "string",
                "firstBind": "string",
                "lastBind": "string",
                "lastLogin": "string",
                "lastOffline": "string",
                "expTime": "string",
                "logLevel": 5,
                "rssi": 0,
                "createdTime": "string",
                "status": 0,
                "isEnable": 0,
                "withProperties": {},
                "protocolConf": [
                    {
                        "key": "string",
                        "value": "string"
                    }
                ],
                "subProtocolConf": [
                    {
                        "key": "string",
                        "value": "string"
                    }
                ],
                "profiles": {},
                "owner": {
                    "userID": "string",
                    "userName": "string",
                    "email": "string",
                    "phone": "string",
                    "lastIP": "string",
                    "regIP": "string",
                    "nickName": "string",
                    "headImg": "string",
                    "createdTime": "string"
                },
                "ratedPower": 0,
                "netType": 10,
                "needConfirmVersion": "string",
                "userID": "string",
                "lastIp": "string",
                "lastLocalIp": "string",
                "sort": 0,
                "deviceImg": "string",
                "isUpdateDeviceImg": true,
                "file": "string",
                "isUpdateFile": true,
                "desc": "string",
                "distributor": {
                    "id": 0,
                    "idPath": "string"
                },
                "gateway": {},
                "area": {
                    "projectID": "string",
                    "areaID": "string",
                    "areaName": "string"
                },
                "groups": [
                    {
                        "id": 0,
                        "parentID": 0,
                        "name": "string",
                        "purpose": "string"
                    }
                ],
                "groupPurpose": "string",
                "groupIDs": [
                    "string"
                ]
            }
        ],
        "page": 0,
        "pageSize": 0,
        "total": 0
    }
}

修改于 2026-01-25 11:44:25

绑定token状态查询