调用该接口获取物的基本信息。

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

请求参数

名称 类型 是否必选 示例值 描述
iotId String 设备ID,生活物联网平台为设备颁发的ID,设备的唯一标识符。productKey和deviceName为空时,该入参不允许为空。
productKey String 产品的Key,设备证书信息之一。创建产品时,生活物联网平台为该产品颁发的全局唯一标识。当iotId为空时,该参数不允许为空。
deviceName String 设备的名称,设备证书信息之一。在注册设备时,自定义的或系统生成的设备名称,具备产品维度内的唯一性。当iotId为空时,该参数不允许为空。

返回数据

名称 类型 示例值 描述
gmtModified Long

数据修改的时间。

activeTime Long

设备激活的时间。

gmtCreate Long

设备创建的时间。

productKey String

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

statusLast Int

上一次设备的状态。

mac String

MAC地址。

deviceSecret String

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

iotId String

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

name String

设备的名称。

nickname String

设备的昵称或别名。

sdkVersion String

SDK的版本。

sn String

设备的SN序列号。

thingType String

设备的类型。

region String

设备所属的区域。

firmwareVersion String

固件的版本号。

rbacTenantId String

租户ID。

status Int

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

示例

请求示例

{
	"id": "1509086454180",
	"version": "1.0",
	"request":{
		"apiVer": "1.0.2"
	},
	"params":{
		"iotId": "value0",
		"productKey": "value1",
		"deviceName": "value2"
	}
}

正常返回示例

JSON 格式

{
    "code": 200,
    "data": {
        "gmtModified": 1517918765000,
        "activeTime": null,
        "deviceKey": "Kq7rgxxxxexwJh",
        "gmtCreate": 1500017648000,
        "productKey": "kQxxxxqA",
        "statusLast": null,
        "mac": null,
        "netAddress": null,
        "deviceSecret": "xxxxxxxxxxxxxxxxxxxxx",
        "iotId": "03iGXYVlxxxx9ccwgzHG",
        "name": "Kq7rgvxxxxexwJh",
        "tenantId": 7,
        "nickname": null,
        "sdkVersion": null,
        "sn": null,
        "thingType": "DEVICE",
        "region": "daily",
        "firmwareVersion": "1.0.0",
        "rbacTenantId": "ADSBCUYxxxxxx27917",
        "ownerDomain": "kQxxxxqA",
        "status": 1
    },
    "message": "success",
    "localizedMsg": null
}

异常返回示例

JSON 格式

{}