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

  • 物联网平台

  • 边缘计算平台

  • 应用硬件开发平台

  • API文档

    • 边缘

    • 模型

    • 设备

      • 创建设备
      • 删除设备
      • 同步下发命令
      • 异步下发命令
      • 更新设备
      • 更新设备元数据信息
      • 查询设备命令结果
      • 查询设备操作日志
      • 获取设备信息
        • 基本信息
      • 获取设备元数据信息
    • 数据

    • 天气

    • 项目

  • 开发侧文档
  • API文档
  • 设备
2021-11-29

获取设备信息

# 获取设备信息

# 基本信息

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

失败示例:

{
    "code": 20001,
    "message": "服务器内部错误,请联系管理员",
    "key": null
}
1
2
3
4
5
上次更新: 2021-12-01 16:48:01

← 查询设备操作日志 获取设备元数据信息→

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