文档

获取物的基本信息

更新时间:
一键部署

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

路径

/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 格式

{}
  • 本页导读 (0)
文档反馈