获取设备信息
# 获取设备信息
# 基本信息
API Path /giot/v2/devices/{id}
请求协议 HTTP
请求方法 GET
Query参数:
| 参数名 | 说明 | 必填 | 类型 | 限制 | 示例 |
|---|---|---|---|---|---|
| productCode | 产品code | 是 | [string] |
Rest参数:
| 参数名 | 说明 | 必填 | 类型 | 值可能性 | 限制 | 示例 |
|---|---|---|---|---|---|---|
| id | 设备ID | 是 | [string] |
响应内容:
返回结果 Json Object
| 参数名 | 说明 | 必填 | 类型 | 值可能性 | 限制 | 示例 |
|---|---|---|---|---|---|---|
| accessToken | 设备token | 否 | [string] | |||
| activateTime | 激活时间 | 否 | [string] | |||
| appCommProtocol | 应用通信协议 | 否 | [string] | |||
| batchNumber | 批次号 | 否 | [string] | |||
| category | 设备分类0: 自有设备;1: 授权设备 | 否 | [int] | |||
| channelId | 否 | [string] | ||||
| childDeviceCount | 子设备个数 | 否 | [int] | |||
| commType | 通信类型 | 否 | [string] | |||
| companyCode | 厂商编码 | 否 | [string] | |||
| companyName | 厂商名称 | 否 | [string] | |||
| companyVO | 否 | [object] | ||||
| companyVO>>address | 厂商地址 | 否 | [string] | |||
| companyVO>>code | 厂商code | 否 | [string] | |||
| companyVO>>createTime | 厂商创建时间 | 否 | [string] | |||
| companyVO>>creator | 厂商创建者 | 否 | [string] | |||
| companyVO>>creatorLabel | 厂商创建者名称 | 否 | [string] | |||
| companyVO>>creditCode | 厂商编码 | 否 | [string] | |||
| companyVO>>deleted | 是否删除 | 否 | [boolean] | |||
| companyVO>>entStatus | 否 | [string] | ||||
| companyVO>>entType | 否 | [string] | ||||
| companyVO>>epc96Code | 否 | [string] | ||||
| companyVO>>homepage | 否 | [string] | ||||
| companyVO>>name | 厂商名称 | 否 | [string] | |||
| companyVO>>nameEn | 否 | [string] | ||||
| companyVO>>operName | 否 | [string] | ||||
| companyVO>>orgNo | 否 | [string] | ||||
| companyVO>>pushIP | 否 | [string] | ||||
| companyVO>>recCap | 否 | [string] | ||||
| companyVO>>registCapi | 否 | [string] | ||||
| companyVO>>scope | 否 | [string] | ||||
| companyVO>>serviceIP | 否 | [string] | ||||
| companyVO>>shortName | 否 | [string] | ||||
| companyVO>>startDate | 否 | [string] | ||||
| companyVO>>status | 否 | [int] | ||||
| companyVO>>type | 否 | [int] | ||||
| companyVO>>updateTime | 否 | [string] | ||||
| companyVO>>updater | 否 | [string] | ||||
| companyVO>>updaterLabel | 否 | [string] | ||||
| companyVO>>version | 否 | [int] | ||||
| createTime | 设备创建时间 | 否 | [string] | |||
| creator | 设备创建者id | 否 | [string] | |||
| creatorLabel | 设备创建者名称 | 否 | [string] | |||
| dataUpdateTime | 最新上报时间 | 否 | [string] | |||
| deleted | 是否删除 | 否 | [boolean] | |||
| description | 描述 | 否 | [string] | |||
| devType | 设备型号 | 否 | [string] | |||
| deviceTags | 设备标签 | 否 | [array] | |||
| deviceTags>>deleted | 否 | [boolean] | ||||
| deviceTags>>deviceId | 设备id | 否 | [string] | |||
| deviceTags>>id | 标签id | 否 | [int] | |||
| deviceTags>>tagDesc | 标签描述 | 否 | [string] | |||
| deviceTags>>tagKey | 标签key | 否 | [string] | |||
| deviceTags>>tagValue | 标签值 | 否 | [string] | |||
| deviceType | 设备类型 | 否 | [string] | |||
| deviceTypeLabel | 设备类型名称 | 否 | [string] | |||
| downCount | 否 | [int] | ||||
| downSize | 否 | [int] | ||||
| expiredTime | 过期时间 | 否 | [string] | |||
| fileUuid | 否 | [string] | ||||
| id | 设备id | 否 | [string] | |||
| jobId | 否 | [string] | ||||
| mac | mac地址 | 否 | [string] | |||
| mainHardVersion | MCU硬件版本 | 否 | [string] | |||
| mainVersion | MCU软件版本 | 否 | [string] | |||
| metadata | 否 | [string] | ||||
| modHardVersion | 模组硬件版本 | 否 | [string] | |||
| modSoftVersion | 模组软件版本 | 否 | [string] | |||
| mode | 模组工作方式 | 否 | [string] | |||
| modelId | 模型id | 否 | [string] | |||
| modelLabel | 模型名称 | 否 | [string] | |||
| modelType | 模型类型 | 否 | [int] | |||
| name | 设备名称 | 否 | [string] | |||
| netOperator | 运营商 | 否 | [int] | |||
| offlineTime | 离线时间 | 否 | [string] | |||
| online | 是否在线0离线1在线-1未激活 | 否 | [int] | |||
| onlineTime | 最后上线时间 | 否 | [string] | |||
| packageId | 否 | [string] | ||||
| parentId | 网关设备id(针对子设备) | 否 | [string] | |||
| productCode | 产品编码 | 否 | [string] | |||
| productCodes | 否 | [array] | ||||
| productCodes>>createTime | 否 | [string] | ||||
| productCodes>>deleted | 否 | [boolean] | ||||
| productCodes>>destPCode | 否 | [string] | ||||
| productCodes>>deviceAuthModelVOS | 否 | [array] | ||||
| productCodes>>deviceAuthModelVOS>>createTime | 否 | [string] | ||||
| productCodes>>deviceAuthModelVOS>>deleted | 否 | [boolean] | ||||
| productCodes>>deviceAuthModelVOS>>deviceAuthId | 否 | [string] | ||||
| productCodes>>deviceAuthModelVOS>>deviceModelName | 否 | [string] | ||||
| productCodes>>deviceAuthModelVOS>>deviceModelType | 否 | [int] | ||||
| productCodes>>deviceAuthModelVOS>>id | 否 | [string] | ||||
| productCodes>>deviceAuthModelVOS>>modelId | 否 | [string] | ||||
| productCodes>>deviceAuthModelVOS>>sysType | 否 | [int] | ||||
| productCodes>>deviceAuthModelVOS>>updateTime | 否 | [string] | ||||
| productCodes>>deviceAuthTenantVOS | 否 | [array] | ||||
| productCodes>>deviceAuthTenantVOS>>createTime | 否 | [string] | ||||
| productCodes>>deviceAuthTenantVOS>>deleted | 否 | [boolean] | ||||
| productCodes>>deviceAuthTenantVOS>>deviceAuthId | 否 | [string] | ||||
| productCodes>>deviceAuthTenantVOS>>id | 否 | [string] | ||||
| productCodes>>deviceAuthTenantVOS>>tenantId | 否 | [string] | ||||
| productCodes>>deviceAuthTenantVOS>>tenantName | 否 | [string] | ||||
| productCodes>>deviceAuthTenantVOS>>updateTime | 否 | [string] | ||||
| productCodes>>id | 否 | [string] | ||||
| productCodes>>productName | 否 | [string] | ||||
| productCodes>>readonly | 否 | [int] | ||||
| productCodes>>sourcePCode | 否 | [string] | ||||
| productCodes>>updateTime | 否 | [string] | ||||
| productName | 产品名称 | 否 | [string] | |||
| projectId | 项目id | 否 | [string] | |||
| projectName | 项目名称 | 否 | [string] | |||
| protoV | 设备协议版本1:1.0设备2: 2.0设备 | 否 | [string] | |||
| readonly | 否 | [int] | ||||
| status | 设备状态0禁用1启用 | 否 | [boolean] | |||
| sysType | 1: 系统模型0:自定义模型 | 否 | [int] | |||
| tenantId | 租户id | 否 | [string] | |||
| tenantName | 租户名称 | 否 | [string] | |||
| test | 否 | [boolean] | ||||
| thirdDid | 否 | [string] | ||||
| upCount | 否 | [int] | ||||
| upSize | 否 | [int] | ||||
| updateTime | 否 | [string] | ||||
| updater | 否 | [string] | ||||
| version | 否 | [int] |
成功示例:
{
"id": "33fe1bfa24ad4997a7b2dc463db67aa5", // 设备id
"name": "aa", //名称
"tenantId": "1", // 租户id
"projectId": "36", // 项目id
"productCode": "pmpp", // 产品编码
"companyCode": "12110000400685627C", // 厂商编码
"channelId": null, // 通道id
"jobId": null,
"modelId": "731f9247b0cb4551b9da596da12b671f", // 模型id
"modelType": 1, // 模型类型
"thirdDid": null,
"online": -1, // 是否在线 0离线 1在线 -1未激活
"status": true, // 设备状态 0禁用 1启用
"accessToken": "242d3a7888754fd8a6331e8a3c8ca0d8", // 设备token
"parentId": null, // 网关设备id(针对子设备)
"test": null,
"deviceType": "SmartBracelet", // 设备类型
"description": null, // 描述
"offlineTime": null, // 最后离线时间
"downCount": null,
"upCount": null,
"downSize": null,
"upSize": null,
"onlineTime": null, // 最后上线时间
"dataUpdateTime": null,
"activateTime": null, // 设备激活时间
"metadata": null,
"creator": "10000",
"updater": "10000",
"createTime": 1630983980000,
"updateTime": 1630983980000,
"version": null,
"deleted": false,
"mode": null, //模组工作方式
"modType": null, //模组类型
"modSoftVersion": null, //模组软件版本
"modHardVersion": null, //模组硬件版本
"commType": null, //通信类型
"mac": null, // mac地址
"appCommProtocol": null, //应用通信协议
"netOperator": null, //运营商
"mainVersion": null, //MCU软件版本
"mainHardVersion": null, //MCU硬件版本
"devType": null, //设备型号
"batchNumber": null, //批次号
"packageId": null,
"fileUuid": null,
"expiredTime": null,
"modelLabel": "智能手环", // 模型名称
"childDeviceCount": null, // 子设备个数
"creatorLabel": "系统管理员",
"deviceTypeLabel": "通用设备/智能手环", // 设备类型名称
"productCodes": null,
"deviceTags": [], // 设备标签
"companyVO": null,
"companyName": "北京市科学技术研究院", // 厂商名称
"tenantName": "住总集团修改1", // 租户名称
"projectName": "FFF720", // 项目名称
"productName": "数字项目管理平台", // 产品名称
"readonly": null,
"protoV": "1", // 设备协议版本 1:1.0设备 2: 2.0设备
"category": 0, // 设备分类 0:自有设备;1:授权设备
"sysType": 1 //1:系统模型 0:自定义模型
}
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
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
失败示例:
{
"code": 20001,
"message": "服务器内部错误,请联系管理员",
"key": null
}
1
2
3
4
5
2
3
4
5
上次更新: 2021-12-01 16:48:01