调用该接口批量获取物的列表。

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

请求参数

名称 类型 是否必选 示例值 描述
productKey String 产品的Key,设备证书信息之一。创建产品时,生活物联网平台为该产品颁发的全局唯一标识。
status Int 设备状态。0(表示未激活);1(表示在线);3(表示离线);8(表示禁用)。
currentPage Int 分页查询。
pageSize Int 20 分页大小。取值范围:1~200。

返回数据

名称 类型 示例值 描述
totalNum Long

总的记录数目。

items String

设备列表,列表中参数与/cloud/thing/info/get接口的返回参数一致。

示例

请求示例

{
	"id": "1509086454180",
	"version": "1.0",
	"request":{
		"apiVer": "1.0.2"
	},
	"params":{
		"productKey": "value0",
		"status": "value1",
		"currentPage": "value2",
		"pageSize":20
	}
}

正常返回示例

JSON 格式

{
    "code": 200,
    "data": [
        {
            "gmtModified": 1517922329000,
            "offset": null,
            "activeTime": null,
            "deviceKey": "d7Clxxxxu1Lp",
            "gmtCreate": 1501110001000,
            "productKey": "wxxxxtR",
            "statusLast": null,
            "mac": null,
            "netAddress": null,
            "iotId": "d7CllTxxx0010990700",
            "deviceSecret": "u98xxxxzhy/4cV1ThAEGxxxxf48Cf6YX+sqcP1Ky7",
            "name": "\r\n",
            "tenantId": 7,
            "nickname": null,
            "limit": null,
            "sdkVersion": null,
            "sn": null,
            "thingType": "DEVICE",
            "region": "daily",
            "firmwareVersion": null,
            "rbacTenantId": "ADSBCxxxx327917",
            "ownerDomain": "wLxxxxtR",
            "status": 1
        },
        {
            "gmtModified": 1517922329000,
            "offset": null,
            "activeTime": null,
            "deviceKey": "K1XuExxxxWgiQaq",
            "gmtCreate": 1501123511000,
            "productKey": "wxxxR",
            "statusLast": null,
            "mac": null,
            "netAddress": null,
            "iotId": "K1XuEDskxxxxxxxxq0010d93300",
            "deviceSecret": "bZxxxj/hZs27AJsNKg3xxxxxxxxxxxxjqcP1Ky7",
            "name": "K1XuxxxxgiQaq",
            "tenantId": 7,
            "nickname": null,
            "limit": null,
            "sdkVersion": null,
            "sn": null,
            "thingType": "DEVICE",
            "region": "daily",
            "firmwareVersion": null,
            "rbacTenantId": "ADSBCUYxxxx27918327917",
            "ownerDomain": "wLxxxxtR",
            "status": 1
        }
    ],
    "message": "success",
    "localizedMsg": null
}

异常返回示例

JSON 格式

{}