获取设备详情
POST
/api/v1/things/device/info/read请求参数
Body 参数application/json
productID
string
可选
产品id 为空时获取所有产品
deviceName
string
设备名称 读写
withProperties
array[string]
可选
如果不为nil,如果为空,获取设备所有最新属性 如果传了属性列表,则会返回属性列表
withProfiles
array[string]
可选
withOwner
boolean
可选
同时获取拥有人的信息
withGateway
boolean
可选
同时返回子设备绑定的网关信息
withArea
boolean
同时返回区域信息
示例
{
"productID": "string",
"deviceName": "string",
"withProperties": [
"string"
],
"withProfiles": [
"string"
],
"withOwner": true,
"withGateway": true,
"withArea": true
}
示例代码
返回响应
成功(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
A successful response.
数据结构
code
integer
返回code
默认值:
200
msg
string
返回的消息
data
object (DeviceInfo)
可选
id
integer <int64>
可选
tenantCode
string
可选
productID
string
产品id 只读
projectID
string
项目id 只读
productName
string
可选
deviceType
integer <int64>
可选
设备类型:1:直连设备,2:网关,3:子设备,4:监控设备
productImg
string
产品图片
areaID
string
项目区域id 只读
deviceName
string
设备名称 读写
deviceAlias
string
设备别名 读写
secret
string
设备秘钥 只读
cert
string
设备证书 只读
imei
string
可选
IMEI号信息 只读
mac
string
可选
MAC号信息 只读
categoryID
integer <int64>
产品品类
version
string
固件版本 读写
hardInfo
string
可选
模组硬件型号 只读
softInfo
string
可选
模组软件版本 只读
mobileOperator
integer <int64>
可选
移动运营商:1)移动 2)联通 3)电信 4)广电
<= 10
phone
string
手机号
iccid
string
SIM卡卡号
position
object (Point)
可选
address
string
所在地址
adcode
string
地区编码
tags
array[object (Tag) {2}]
设备tag
schemaAlias
object
可选
设备物模型别名,如果是结构体类型则key为xxx.xxx
isOnline
integer <int64>
可选
在线状态 1离线 2在线 只读
<= 2
firstLogin
string
激活时间 只读
firstBind
string
可选
lastBind
string
最后绑定时间 只读
lastLogin
string
最后上线时间 只读
expTime
string
到期时间
logLevel
integer <int64>
可选
日志级别:1)关闭 2)错误 3)告警 4)信息 5)调试 读写
<= 5
rssi
integer <int64>
信号强度
createdTime
string
创建时间 只读
status
integer <int64>
可选
设备状态 1-未激活,2-在线,3-离线 4-异常(频繁上下线,告警中)
isEnable
integer <int64>
是否启用
withProperties
object
可选
获取的属性列表,如果不传withProperty,则不会返回
protocolConf
array[object (Tag) {2}]
协议配置
profiles
object
可选
owner
object (UserCore)
可选
ratedPower
integer <int64>
可选
netType
integer <int64>
可选
通讯方式:1:其他,2:wi-fi,3:2G/3G/4G,4:5G,5:BLE,6:LoRaWAN,7:wifi+ble,8:有线网
<= 8
needConfirmVersion
string
待确认升级的版本
userID
string
可选
lastIp
string
最后登录的ip地址
desc
string
可选
distributor
object (IDPath)
可选
gateway
object (DeviceInfo)
可选
area
object (AreaInfo)
可选
groups
array[object (GroupCore) {4}]
所在分组信息
示例
未设置
最后修改时间: 4 天前