调用该接口获取物的信息,例如设备名称、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 格式

{}