調用該接口獲取物的信息,例如設備名稱、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格式

{}