设备 - 属性 - 属性写值

大约 2 分钟

设备 - 属性 - 属性写值

属性写值

sys/{product_id}/{device_id}/thing/properties/set

说明:

物联网平台用于设置设备属性

示例:

{
    "id": "123",
    "version": "1.0",
    "params": {
        "temperature": "30.5"
    },
    "method": "thing.properties.set"
}

字段说明:

表 3. 请求参数说明
参数类型说明
idString

消息ID号,String类型的数字,取值范围0~4294967295,且每个消息ID在当前设备中具有唯一性。

versionString协议版本号,目前协议版本号唯一取值为1.0。
paramsObject属性设置参数。如以上示例中,设置属性:{ "temperature": "30.5" }

如果是自定义模块属性,属性标识符格式为${模块标识符}:${属性标识符}(中间为英文冒号),例如{ "test:temperature": "30.5" }

methodString请求方法。例如:thing.properties.set

属性写值回复

sys/{product_id}/{device_id}/thing/properties/set/response

成功返回示例:

{
    "code": 200,
    "data": {},
    "id": "123",
    "message": "success",
    "method": "thing.properties.set",
    "version": "1.0"
}

失败返回示例:

{
    "code": 460,
    "data": {},
    "id": "123",
    "message": "request parameter error!",
    "method": "thing.properties.set",
    "version": "1.0"
}

说明

设备端响应属性写值结果

字段说明:

参数类型说明
idString消息ID号,String类型的数字,取值范围0~4294967295,且每个消息ID在当前设备中具有唯一性。
codeInteger结果状态码。 具体参考设备端通用code
说明 物联网平台会对设备上报的属性做校验。通过产品的TSL描述判断上报的属性是否符合定义的属性格式。不合格的属性会直接被过滤掉,并返回失败的错误码。
dataObject请求成功时,返回的数据固定为空。
messageString返回结果信息。请求成功时,返回success。
methodString响应数据对应的请求方法,与请求参数中method相同。
versionString协议版本号,与请求参数中version相同。