使用该接口为指定的设备设置属性。
请求语法
POST /2019-09-30/things/ProductKey/DeviceName/properties HTTP/1.1
Cookie: Cookie
Payload
请求参数
参数名称 | 类型 | 是否必选 | 描述 |
ProductKey | String | 是 | 设备所属产品的唯一标识符。可从物联网平台控制台获取。 |
DeviceName | String | 是 | 设备的名称。可从物联网平台控制台获取。 |
Cookie | String | 是 | 调用CreateAuthCookie接口创建的认证Cookie。 |
Payload | JSON | 是 | 设置设备属性。格式请见表格下方请求Payload格式。 |
请求Payload格式如下所示。
{
"Properties": {
"Identifier1": value1,
"Identifier2": value2,
"Identifier3": value3
...
}
}
返回语法
HTTP/1.1 StatusCode
Content-Type: application/json
Payload
返回参数
参数名称 | 类型 | 描述 |
StatusCode | Number | HTTP状态码。返回200表示成功,返回其它状态码表示失败。状态码详情请参见状态码。 |
Payload | JSON | 底层属性设置接口返回的内容。 |
返回Payload格式如下所示。
{
"Code": 200,
"Message": "sucess|reason for failure",
"Data": {
"Data": string|boolean|number|array|object, // A optional data that returned from the underlying set
"Timestamp": 1568262117344
}
}
完整示例
$ curl -b token.cookie -d '{"Properties":{"LightSwitch":0}}' -k -X POST https://127.0.0.1:9999/2019-09-30/things/a1WabAEC***/N0hB9tiVWWZFMpALK***/properties
{"Data":{"Data":[],"Timestamp":1572512468781},"Code":200,"Message":"success"}
文档内容是否对您有帮助?