广联达筑联:工业级物联网云平台 广联达筑联:工业级物联网云平台
首页
开发侧文档
用户侧文档
首页
开发侧文档
用户侧文档
  • 平台介绍

  • 物联网平台

  • 边缘计算平台

  • 应用硬件开发平台

  • API文档

    • 边缘

    • 模型

      • 查询模型列表
        • 基本信息
      • 查询模型下设备列表
      • 查询模型详情
    • 设备

    • 数据

    • 天气

    • 项目

  • 开发侧文档
  • API文档
  • 模型
2021-11-29

查询模型列表

# 查询模型列表

# 基本信息

API Path /giot/v2/deviceModels

请求协议 HTTP

请求方法 GET

Query参数:

参数名 说明 必填 类型 限制 示例
name 模型名称 否 [string]
productCode 产品编码 是 [string]
sysType 是否为系统模型 否 [boolean]
modelType 模型类型 1:直连 2:网关 3:网关子设备 否 [int]
pageSize 分页大小 否 [int] 10
pageIndex 分页页码 否 [int] 1
deviceType 设备类型 否 [string]

响应内容:

返回结果 Json Object

参数名 说明 必填 类型 值可能性 限制 示例
currentPage 当前页 否 [int]
recordTotal 总页数 否 [int]
records 否 [array]
records>>actions 命令列表 否 [object]
records>>attributes 属性列表 否 [object]
records>>createTime 创建时间 否 [string]
records>>creator 创建人 否 [string]
records>>creatorLabel 创建人标签 否 [string]
records>>deleted 是否删除 否 [boolean]
records>>description 描述 否 [string]
records>>deviceType 设备类型 否 [string]
records>>deviceTypeLabel 设备类型标签 否 [string]
records>>events 事件列表 否 [object]
records>>id 主键ID 否 [string]
records>>metadata 否 [string]
records>>modelType 模型类型 否 [int]
records>>name 名称 否 [string]
records>>parentId 父模型ID 否 [string]
records>>productCode 产品编码 否 [string]
records>>productToken 产品token 否 [string]
records>>protocolType 协议类型 否 [int]
records>>stat 否 [boolean]
records>>sysType 是否是系统模型 否 [boolean]
records>>updateTime 更新时间 否 [string]
records>>updater 更新人 否 [string]
records>>updaterLabel 更新标签 否 [string]
records>>version 版本号 否 [int]
totalPage 总页数 否 [int]

成功示例:

[
    {
        "id": "8590d8ce67db4a75abe628afd8220842@#version@#1626846935000", //设备id @# 属性code @# 时间戳
        "tenantId": null, //租户ID
        "projectId": "487050709635584", //项目ID
        "modelId": null, //模型ID
        "deviceId": "8590d8ce67db4a75abe628afd8220842", //设备ID
        "dataType": 4, //数据类型  1:整型 2:浮点型 3:布尔型 4:文本型 5:JSON格式 6:枚举类
        "code": "version", //属性编码
        "value": "1.0.1", //属性值
        "timestamp": 1626846935000, //上报时间戳
        "createdTime": 1626846935000, //创建时间
        "updatedTime": null //更新时间
    }
]

[
    {
        "id": "8590d8ce67db4a75abe628afd8220842@#version@#1626846935000", //设备id @# 属性code @# 时间戳
        "tenantId": null, //租户ID
        "projectId": "487050709635584", //项目ID
        "modelId": null, //模型ID
        "deviceId": "8590d8ce67db4a75abe628afd8220842", //设备ID
        "dataType": 4, //数据类型  1:整型 2:浮点型 3:布尔型 4:文本型 5:JSON格式 6:枚举类
        "code": "version", //属性编码
        "value": "1.0.1", //属性值
        "timestamp": 1626846935000, //上报时间戳
        "createdTime": 1626846935000, //创建时间
        "updatedTime": null //更新时间
    }
]

{
    "deviceId": "8590d8ce67db4a75abe628afd8220842", //设备ID
    "updatedTime": 1626846930000, //更新时间
    "expiredTime": 213213213, //过期时间
    "status": "disconnected" //设备在线状态
}

[
    {
        "deviceId": "8590d8ce67db4a75abe628afd8220842", //设备ID
        "updatedTime": null, //更新时间
        "expiredTime": null, //过期时间
        "status": "disconnected" //设备在线状态
    },
    {
        "deviceId": "d9a03120e15a4d6eb4f403f20a0b2bdb",
        "updatedTime": null,
        "expiredTime": null,
        "status": "disconnected"
    }
]

[
    {
        "id": "0003b3dd-31c9-4c42-bdf5-e499790714f9", //设备ID
        "status": "disconnected", //设备状态
        "attributeMap": {}, //属性列表
        "createdTime": null, //创建时间
        "updatedTime": null //更新时间
    }
]

{
    "id": "8590d8ce67db4a75abe628afd8220842", //设备ID
    "status": "disconnected", //设备在线状态
    "attributeMap": { //属性列表
        "version": {
            "id": "8590d8ce67db4a75abe628afd8220842@#Wed Jul 21 13:55:35 CST 2021", //设备id @# 时间
            "name": "部署版本", //属性名称
            "code": "version", //属性编码
            "type": 4, //属性类型
            "latest": "1.0.1", //属性值
            "time": 1626846935404 //时间戳
        }
    },
    "createdTime": 1626846935404, //创建时间
    "updatedTime": 1626846935404 //更新时间
}

{
    "deviceId": "0003b3dd-31c9-4c42-bdf5-e499790714f9", //设备ID
    "updatedTime": null, //更新时间
    "expiredTime": 32434, //设备过期时间
    "status": "active" //设备在线状态
}

{
    "recordTotal": 401, //查询总数据量
    "totalPage": 41, //一共多少页
    "currentPage": 1, //当前第几页
    "records": [
        {
            "id": "92d550b9-c727-413d-b9bb-22ba24e7b4cd", //模型ID
            "name": "ARM盒子", //模型名称
            "productToken": null,//产品token
            "productCode": "pmpp", //产品编码
            "description": "bbbbb", //模型描述
            "deviceType": "Surveillance", //设备类型
            "protocolType": 1, //协议类型  0:mqtt 1:http 2: NB
            "modelType": 1, //模型类型 1:直连 2:网关 3:网关子设备
            "sysType": false, //是否是系统模型
            "metadata": "{\"标签\":\"标签内容\"}", //模型元数据
            "parentId": null, //项目ID
            "creator": "10000", //创建人
            "updater": null, //更新人
            "createTime": 1606211109000, //创建时间戳
            "updateTime": 1606211744000, //更新时间戳
            "deleted": false, //是否被删除
            "version": null, //版本
            "stat": false, 
            "deviceTypeLabel": null, //设备类型标签
            "creatorLabel": null, //创建人标签
            "updaterLabel": null, //更新人标签
            "attributes": { //属性列表
                "code": {
                    "id": "1fb159ff88804ff1a0594ae5ffba54b1", //属性ID
                    "modelId": "92d550b9-c727-413d-b9bb-22ba24e7b4cd", //模型ID
                    "code": "code", //属性code
                    "name": "code", //属性名称
                    "dataType": 1, //数据类型  1:整型 2:浮点型 3:布尔型 4:文本型 5:JSON格式 6:枚举类
                    "description": "",//属性米欧奥数
                    "readable": true, //是否只读
                    "step": 2.0, //步长
                    "max": 222.0, //最大值
                    "min": 2.0, //最小值
                    "symbolId": null, //符号代码
                    "length": null, //长度
                    "createTime": 1623408667000, //创建时间
                    "updateTime": null, //更新时间
                    "version": null, //版本号
                    "deleted": 0, //是否删除
                    "sysType": false, //是否是系统模型属性
                    "enumsData": [] //枚举列表
                },
                "22": {
                    "id": "5eba6c2548074d46baef04967e6c717b",
                    "modelId": "92d550b9-c727-413d-b9bb-22ba24e7b4cd",
                    "code": "22",
                    "name": "block",
                    "dataType": 1,
                    "description": "",
                    "readable": true,
                    "step": 2.0,
                    "max": 222.0,
                    "min": 2.0,
                    "symbolId": null,
                    "length": null,
                    "createTime": 1623408526000,
                    "updateTime": null,
                    "version": null,
                    "deleted": 0,
                    "sysType": false,
                    "enumsData": []
                },
                "nba": {
                    "id": "ffd53429d3064841a3a8ef640ea8e520",
                    "modelId": "92d550b9-c727-413d-b9bb-22ba24e7b4cd",
                    "code": "nba",
                    "name": "nba",
                    "dataType": 1,
                    "description": "",
                    "readable": true,
                    "step": 2.0,
                    "max": 22222.0,
                    "min": 2.0,
                    "symbolId": null,
                    "length": null,
                    "createTime": 1623408315000,
                    "updateTime": null,
                    "version": null,
                    "deleted": 0,
                    "sysType": false,
                    "enumsData": []
                },
                "323": {
                    "id": "8e4720c279c74c32924f140ef118f0d2",
                    "modelId": "92d550b9-c727-413d-b9bb-22ba24e7b4cd",
                    "code": "323",
                    "name": "wqewqe",
                    "dataType": 1,
                    "description": "",
                    "readable": true,
                    "step": 2.0,
                    "max": 222.0,
                    "min": 22.0,
                    "symbolId": null,
                    "length": null,
                    "createTime": 1623408279000,
                    "updateTime": null,
                    "version": null,
                    "deleted": 0,
                    "sysType": false,
                    "enumsData": []
                },
                "test": {
                    "id": "a79154affdec46a189bf51b6fcb9de5e",
                    "modelId": "92d550b9-c727-413d-b9bb-22ba24e7b4cd",
                    "code": "test",
                    "name": "test123456",
                    "dataType": 1,
                    "description": "",
                    "readable": true,
                    "step": 222.0,
                    "max": 2222.0,
                    "min": 2.0,
                    "symbolId": null,
                    "length": null,
                    "createTime": 1623408267000,
                    "updateTime": null,
                    "version": null,
                    "deleted": 0,
                    "sysType": false,
                    "enumsData": []
                },
                "2321": {
                    "id": "b4f46d746a4343b68392cb6d1a4dd788",
                    "modelId": "92d550b9-c727-413d-b9bb-22ba24e7b4cd",
                    "code": "2321",
                    "name": "testtest",
                    "dataType": 1,
                    "description": "",
                    "readable": true,
                    "step": 2.0,
                    "max": 2222.0,
                    "min": 2.0,
                    "symbolId": null,
                    "length": null,
                    "createTime": 1623408219000,
                    "updateTime": null,
                    "version": null,
                    "deleted": 0,
                    "sysType": false,
                    "enumsData": []
                },
                "test000012": {
                    "id": "d292aa2bc6db4f14af0deac8ac18ff3b",
                    "modelId": "92d550b9-c727-413d-b9bb-22ba24e7b4cd",
                    "code": "test000012",
                    "name": "test000012",
                    "dataType": 3,
                    "description": "",
                    "readable": true,
                    "step": 2.0,
                    "max": null,
                    "min": null,
                    "symbolId": null,
                    "length": null,
                    "createTime": 1623406213000,
                    "updateTime": null,
                    "version": null,
                    "deleted": 0,
                    "sysType": false,
                    "enumsData": []
                },
                "3333": {
                    "id": "a8ec5955cd864067b13a1b762b2375f8",
                    "modelId": "92d550b9-c727-413d-b9bb-22ba24e7b4cd",
                    "code": "3333",
                    "name": "324234",
                    "dataType": 2,
                    "description": "",
                    "readable": true,
                    "step": 2.0,
                    "max": 2.0,
                    "min": 2.0,
                    "symbolId": null,
                    "length": null,
                    "createTime": 1623401536000,
                    "updateTime": null,
                    "version": null,
                    "deleted": 0,
                    "sysType": false,
                    "enumsData": []
                },
                "attr1": {
                    "id": "b40f8dabfb884c4ab055d5d9b2abf3f4",
                    "modelId": "92d550b9-c727-413d-b9bb-22ba24e7b4cd",
                    "code": "attr1",
                    "name": "属性1",
                    "dataType": 4,
                    "description": null,
                    "readable": false,
                    "step": null,
                    "max": null,
                    "min": null,
                    "symbolId": null,
                    "length": null,
                    "createTime": 1623175708000,
                    "updateTime": null,
                    "version": null,
                    "deleted": 0,
                    "sysType": false,
                    "enumsData": []
                }
            },
            "actions": { //命令列表
                "32323": {
                    "id": "00a56b1d66124d57ad73f9adfac71f82", //命令ID
                    "modelId": "92d550b9-c727-413d-b9bb-22ba24e7b4cd", //模型ID
                    "code": "32323", //模型编码
                    "sync": true, //是否同步
                    "name": "testtest", //模型名称
                    "description": "", //模型描述
                    "createTime": 1623408239000, //创建时间
                    "updateTime": null, //更新时间
                    "version": null, //版本号
                    "deleted": 0, //是否删除
                    "inParams": [], //入参
                    "outParams": [], //出参
                    "sysType": false //系统类型
                },
                "222": {
                    "id": "15ff1f0acafa4f6680a5e9e0aaecdf89",
                    "modelId": "92d550b9-c727-413d-b9bb-22ba24e7b4cd",
                    "code": "222",
                    "sync": true,
                    "name": "2323",
                    "description": "",
                    "createTime": 1623408233000,
                    "updateTime": null,
                    "version": null,
                    "deleted": 0,
                    "inParams": [],
                    "outParams": [],
                    "sysType": false
                },
                "23": {
                    "id": "b1eca18a6ab745e1804d7d9e277dc55d",
                    "modelId": "92d550b9-c727-413d-b9bb-22ba24e7b4cd",
                    "code": "23",
                    "sync": true,
                    "name": "232",
                    "description": "",
                    "createTime": 1623408227000,
                    "updateTime": null,
                    "version": null,
                    "deleted": 0,
                    "inParams": [],
                    "outParams": [],
                    "sysType": false
                },
                "reboot": {
                    "id": "b5696769dd5b4ad7b9a37ca3f79e4acb",
                    "modelId": "92d550b9-c727-413d-b9bb-22ba24e7b4cd",
                    "code": "reboot",
                    "sync": false,
                    "name": "重启",
                    "description": "重启系统",
                    "createTime": 1623175708000,
                    "updateTime": null,
                    "version": null,
                    "deleted": 0,
                    "inParams": [
                        {
                            "id": "630ea0e1852445bda3b3786779c84bd4",
                            "attrId": "b5696769dd5b4ad7b9a37ca3f79e4acb",
                            "code": "delay1",
                            "name": "delay",
                            "dataType": 1,
                            "max": null,
                            "min": null,
                            "step": null,
                            "direction": false,
                            "symbolId": null,
                            "required": true,
                            "length": null,
                            "deleted": 0,
                            "enumsData": []
                        }
                    ],
                    "outParams": [],
                    "sysType": false
                }
            },
            "events": null
        }
    ]
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380

失败示例:

{
    "code": 500,
    "message": "xxxxxxxxxx",
    "key": null
}
1
2
3
4
5
上次更新: 2021-12-01 16:48:01

← 部署方案 查询模型下设备列表→

  • 跟随系统
  • 浅色模式
  • 深色模式
  • 阅读模式