文档

GetThingProperties

更新时间:

使用该接口获取指定设备的属性值。

请求语法

GET /2019-09-30/things/ProductKey/DeviceName/properties?identifiers=Identifier1&identifiers=Identifier2&... HTTP/1.1
Cookie: Cookie

请求参数

参数名称 类型 是否必选 描述
ProductKey String 设备所属产品的唯一标识符。可从物联网平台控制台获取。
DeviceName String 设备的名称。可从物联网平台控制台获取。
Identifiers String 设备的属性标识符列表。最多可检索100条属性值。
Cookie String 调用CreateAuthCookie接口创建的认证Cookie。

返回语法

HTTP/1.1 StatusCode
Content-Type: application/json

Payload

返回参数

参数名称 类型 描述
StatusCode Number HTTP状态码。返回200表示成功,返回其它状态码表示失败。错误码详情请参见状态码
Payload JSON 已获取的设备属性。

返回Payload格式如下所示。

{
    "Code": 200,
    "Message": "sucess|reason for failure",
    "Data": {
        "Properties": {
            "Identifier1": "value1",
            "Identifier2": "value2",
            "Identifier3": "value3"
        },
        "Timestamp": 1568262117344
    }
}

完整示例

$ curl -b token.cookie -k https://127.0.0.1:9999/2019-09-30/things/a1WabAEC***/N0hB9tiVWWZFMpALK***/properties?identifiers=LightSwitch

{"Data":{"Timestamp":1572512318420,"Properties":{"LightSwitch":1}},"Code":200,"Message":"success"}