调用该接口获取物的信息,例如设备名称、MAC地址、设备激活时间等内容。

路径 /thing/info/get
版本号 1.0.4
协议 HTTP,HTTPS
请求方法 POST
是否需要用户身份鉴权 是
超时时间 3000

请求参数

名称 类型 是否必选 示例值 描述
iotId String 是 设备ID,生活物联网平台为设备颁发的ID,设备的唯一标识符。

返回数据

名称 类型 示例值 描述
gmtModified Long

设备记录数据修改时间(此为系统内部使用字段,可不关注)。

activeTime Long

设备首次激活的时间。

gmtCreate Long

设备记录创建时间,对于生活物联网平台而言,是量产时生成设备证书的时间。

productKey String

产品的Key,设备证书信息之一。创建产品时,生活物联网平台为该产品颁发的全局唯一标识。

statusLast Int

上一次设备的状态。

mac String

mac地址。

deviceSecret String

设备的密钥,设备证书信息之一。在注册设备时生活物联网平台为设备颁发的设备密钥,用于认证加密。需与DeviceName成对使用。

iotId String

设备ID,生活物联网平台为设备颁发的ID,设备的唯一标识符。

name String

设备的名称。

sdkVersion String

SDK的版本。

sn String

设备的SN序列号。

thingType String

设备的类型,根据在生活物联网平台创建设备的方式决定,一般正式量产的设备为DEVICE类型, 可取值: VIRTUAL(表示虚拟设备);VIRTUAL_SHADOW(表示虚拟影子设备);DEVICE(表示真实设备)。

firmwareVersion String

固件的版本号。

rbacTenantId String

rbac租户的ID。

status Int

设备状态。0(表示未激活);1(表示在线);3(表示离线);8(表示禁用)。

netAddress String

IP地址。

示例

请求示例

{
	"id": "1509086454180",
	"version": "1.0",
	"request":{
		"apiVer": "1.0.4",
		"iotToken": "token"
	},
	"params":{
		"iotId": "value0"
	}
}

正常返回示例

JSON格式

{
    "code": 200,
    "data": {
        "gmtModified": 1517918765000,
        "activeTime": null,
        "gmtCreate": 1500017648000,
        "productKey": "kQxxxxqA",
        "statusLast": null,
        "mac": null,
        "netAddress": null,
        "deviceSecret": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
        "iotId": "D95D242xxxxxxxx4F31A2697",
        "name": "Kq7rgxxxxxwJh",
        "nickname": null,
        "sdkVersion": null,
        "sn": null,
        "thingType": "DEVICE",
        "firmwareVersion": "1.0.0",
        "rbacTenantId": "ADSBCxxxx918327917",
        "status": 1
    },
    "message": "success",
    "localizedMsg": null
}

异常返回示例

JSON格式

{}