设备列表查询

1. 接口描述

接口请求域名： weilingwith.tencentcloudapi.com 。

设备列表查询/单个查询（支持通过筛选条件查询，设备类型、标签、PID、空间）

默认接口请求频率限制：20次/秒。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见 公共请求参数。

3. 输出参数

4. 示例

示例1 设备列表

成功响应

输入示例

POST / HTTP/1.1
Host: weilingwith.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: DescribeDeviceList
<公共请求参数>

{
    "WorkspaceId": 1016,
    "DeviceTypeSet": [
        "w0701005"
    ],
    "PageNumber": 1,
    "PageSize": 1,
    "ApplicationToken": "wA9bELuI4oulQCBK876UDBxe00dNcxQW"
}

输出示例

{
    "Response": {
        "RequestId": "dd0b4025-2db7-4da3-998a-dda6cfc19441",
        "Result": {
            "DeviceDataSet": [
                {
                    "ActiveTime": "2023-04-13T14:11:24+08:00",
                    "DeviceName": "5f089c7e-0530-44c9-9435-c6aaf92f6a29",
                    "DeviceTagSet": [
                        "西安",
                        "真实"
                    ],
                    "DeviceTypeCode": "5f089c7e-0530-44c9-9435-c6aaf92f6a29",
                    "DeviceTypeName": "5f089c7e-0530-44c9-9435-c6aaf92f6a29",
                    "FieldList": [
                        {
                            "Id": 1,
                            "Key": "color",
                            "Name": "颜色",
                            "Val": ""
                        },
                        {
                            "Id": 3,
                            "Key": "height",
                            "Name": "高度",
                            "Val": ""
                        },
                        {
                            "Id": 64,
                            "Key": "size",
                            "Name": "尺寸",
                            "Val": ""
                        },
                        {
                            "Id": 65,
                            "Key": "weight",
                            "Name": "重量",
                            "Val": ""
                        },
                        {
                            "Id": 66,
                            "Key": "width",
                            "Name": "宽度",
                            "Val": ""
                        },
                        {
                            "Id": 67,
                            "Key": "long",
                            "Name": "长度",
                            "Val": ""
                        },
                        {
                            "Id": 68,
                            "Key": "volume",
                            "Name": "体积",
                            "Val": ""
                        }
                    ],
                    "IsActive": 1,
                    "IsLive": false,
                    "Location": {
                        "X": 30769.744140625,
                        "Y": 10080.6162109375,
                        "Z": 24750
                    },
                    "ModelId": "2000056",
                    "ModelName": "边缘摄像头",
                    "ParentWID": "",
                    "ParentWIDName": "",
                    "ProductAbility": 3,
                    "ProductId": 2000056,
                    "ProductName": "边缘摄像头",
                    "SN": "DS-2DE7530IW-A20190315AACHD00715442W",
                    "SpaceInfoSet": [
                        {
                            "Code": "000137",
                            "Id": "85dc534a-4f69-4553-aad0-368cda0f1e92",
                            "Level": 6,
                            "Name": "滨海大厦"
                        },
                        {
                            "Code": "000137048",
                            "Id": "bf0fb1b4-493c-458f-bf8c-7279963b4928",
                            "Level": 7,
                            "Name": "7F"
                        },
                        {
                            "Code": "00013704800003110",
                            "Id": "472ee223-5caf-46c1-beca-d7238a937733",
                            "Level": 9,
                            "Name": ""
                        }
                    ],
                    "WID": "5f089c7e-0530-44c9-9435-c6aaf92f6a29"
                }
            ],
            "PageNumber": 1,
            "PageSize": 1,
            "TotalPage": 16,
            "TotalRow": 16
        }
    }
}

5. 开发者资源

腾讯云 API 平台

腾讯云 API 平台 是综合 API 文档、错误码、API Explorer 及 SDK 等资源的统一查询平台，方便您从同一入口查询及使用腾讯云提供的所有 API 服务。

API Inspector

用户可通过 API Inspector 查看控制台每一步操作关联的 API 调用情况，并自动生成各语言版本的 API 代码，也可前往 API Explorer 进行在线调试。

SDK

云 API 3.0 提供了配套的开发工具集（SDK），支持多种编程语言，能更方便的调用 API。

• Tencent Cloud SDK 3.0 for Python: GitHub Gitee
• Tencent Cloud SDK 3.0 for Java: GitHub Gitee
• Tencent Cloud SDK 3.0 for PHP: GitHub Gitee
• Tencent Cloud SDK 3.0 for Go: GitHub Gitee
• Tencent Cloud SDK 3.0 for Node.js: GitHub Gitee
• Tencent Cloud SDK 3.0 for .NET: GitHub Gitee
• Tencent Cloud SDK 3.0 for C++: GitHub Gitee
• Tencent Cloud SDK 3.0 for Ruby: GitHub Gitee

命令行工具

• Tencent Cloud CLI 3.0

6. 错误码

以下仅列出了接口业务逻辑相关的错误码，其他错误码详见 公共错误码。