设备 - 服务 - 服务下发

大约 3 分钟

设备 - 服务 - 服务下发

服务下发

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

说明：

物联网平台用于下发设备服务

示例：

{
    "id": "123",
    "version": "1.0",
    "identifier": "powerService",
    "params": {
        "Power": "on",
        "WF": "2"
    },
    "method": "thing.service.set"
}

字段说明：

参数类型说明
idString

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

versionString协议版本号，目前协议版本号唯一取值为1.0。
identifierString为物模型中定义的服务标识符，若为自定义模块，则为${tsl.functionBlockId}:${tsl.service.identifier}
paramsObject服务调用参数。包含服务标识符和服务的值。如以上示例中的两个参数Power（电源）和WF（工作电流）。 
{
"Power": "on",
"WF": "2"
}
methodString请求方法，取值为thing.service.set

服务下发回复

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

成功返回示例：

{
    "code": 200,
    "identifier": "powerService",
    "data": {
        "params": {
            "Power": "on",
            "WF": "2"
        }
    },
    "id": "123",
    "message": "success",
    "method": "thing.service.set",
    "version": "1.0"
}

失败返回示例：

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

说明

设备端响应服务下发结果

字段说明：

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