v1
latestOpenAPI 3.0.32026-07-17178286472.4 KBthings/device/info
thingsDeviceInfo
新增设备
post/api/v1/things/device/info/create
Request body
adcodestring
地区编码
addressstring
所在地址
areaIDstring
项目区域id 只读
categoryIDinteger
产品品类
certstring
设备证书 只读
createdTimestring
创建时间 只读
descstring
deviceAliasstring
设备别名 读写
deviceImgstring
设备图片
deviceNamestring required
设备名称 读写
deviceTypeinteger
设备类型:1:直连设备,2:网关,3:子设备,4:监控设备
expTimestring
到期时间
filestring
设备相关文件
firstBindstring
firstLoginstring
激活时间 只读
groupIDsstring[]
如果要更新分组,必须填写groupPurpose
groupPurposestring
更新的时候使用,将设备该用途下的分组进行更新
hardInfostring
模组硬件型号 只读
iccidstring
SIM卡卡号
idinteger
imeistring
IMEI号信息 只读
isEnableinteger
是否启用
isOnlineinteger
在线状态 1离线 2在线 只读
isUpdateDeviceImgboolean
只有这个参数为true的时候才会更新设备图片,传参为设备图片的file path
isUpdateFileboolean
只有这个参数为true的时候才会更新设备文件,传参为设备文件的file path
lastBindstring
最后绑定时间 只读
lastIpstring
最后登录的ip地址
lastLocalIpstring
最后登录局域网的ip地址
lastLoginstring
最后上线时间 只读
lastOfflinestring
最后下线时间 只读
logLevelinteger
日志级别:1)关闭 2)错误 3)告警 4)信息 5)调试 读写
macstring
MAC号信息 只读
mobileOperatorinteger
移动运营商:1)移动 2)联通 3)电信 4)广电
needConfirmVersionstring
待确认升级的版本
netTypeinteger
通讯方式:1:其他,2:wi-fi,3:2G/3G/4G,4:5G,5:BLE,6:LoRaWAN,7:wifi+ble,8:有线网,9:4G+BLE
phonestring
手机号
productIDstring required
产品id 只读
productImgstring
产品图片
productNamestring
profilesobject
projectIDstring
项目id 只读
ratedPowerinteger
rssiinteger
信号强度
schemaAliasobject
设备物模型别名,如果是结构体类型则key为xxx.xxx
secretstring
设备秘钥 只读
softInfostring
模组软件版本 只读
sortinteger
排序
statusinteger
设备状态 1-未激活，2-在线，3-离线 4-异常(频繁上下线,告警中)
tenantCodestring
userIDstring
versionstring
固件版本 读写
withPropertiesobject
获取的属性列表,如果不传withProperty,则不会返回
Response
A successful response.
codeinteger
msgstring