物的模型服务

更新时间:2018-07-26 14:07:53

提供一组与物(设备)相关的服务接口,客户端应用通过本组服务接口可以实现物信息的查询和控制,查询的内容涉及物的基本信息,物的上报数据信息以及物的TSL定义。

获取物的基本信息

定义描述

path 版本 描述 是否需要用户身份的鉴权
/thing/info/get 1.0.2 获取物的信息,例如设备名称、mac地址、设备激活时间登内容 是,客户端SDK需启用身份的鉴权

请求参数

参数 类型 必填 描述
iotId String 物的唯一标识符

返回参数

参数 类型 必有 描述
gmtModified Long 数据修改时间
activeTime Long 设备激活时间
gmtCreate Long 设备创建时间
productKey String 产品key
statusLast Integer 上一次设备状态
mac String mac地址
deviceSecret String 设备secret
iotId String 设备唯一标识符
name String 设备名称
sdkVersion String sdk版本
sn String 设备sn
thingType String 设备类型
region String 区域
firmwareVersion String 固件版本号
rbacTenantId String 租户id
status Integer 设备状态

示例

请求示例

{
    "id": "1509086454180",
    "version": "1.0",
    "request": {
        "apiVer": "1.0.2",
        "iotToken": "token"
    },
    "params": {
        "iotId": "D95D242941CE821ECCE4F31A2697"
    }
}

正常返回示例

{
    "code": 200,
    "data": {
        "gmtModified": 1517918765000,
        "activeTime": null,
        "deviceKey": "Kq7rgvE2cNGcwtDexwJh",
        "gmtCreate": 1500017648000,
        "productKey": "kQGJJuTl0qA",
        "statusLast": null,
        "mac": null,
        "netAddress": null,
        "deviceSecret": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
        "iotId": "03iGXYVl03e23f667d90269c2ccwgzHG",
        "name": "Kq7rgvE2cNGcwtDexwJh",
        "tenantId": 7,
        "nickname": null,
        "sdkVersion": null,
        "sn": null,
        "thingType": "DEVICE",
        "region": "daily",
        "firmwareVersion": "1.0.0",
        "rbacTenantId": "ADSBCUYAGDCUDD827918327917",
        "ownerDomain": "kQGJJuTl0qA",
        "status": 1
    },
    "message": "success",
    "localizedMsg": null
}

错误码

错误码 错误信息 来源 描述
200 success 系统 成功
400 request error. 系统 请求错误
401 request auth error. 系统 请求认证错误
403 request forbidden. 系统 请求被禁止
404 service not found. 系统 服务未找到
429 too many requests. 系统 太多请求
460 request parameter error. 系统 请求参数错误
500 service error. 系统 服务端错误
503 service not available. 系统 服务不可用

获取物的属性timeline数据

定义描述

path 版本 描述 是否需要用户身份的鉴权
/thing/property/timeline/get 1.0.2 获取物的属性timeline数据 是,客户端SDK需启用身份的鉴权

请求参数

参数 类型 必填 描述
iotId String 物的唯一标识符
identifier String 属性标识符
start Long timeline起始时间
end Long timeline终止时间
pageSize Int 分页查询条数
ordered Boolean 顺序(true)、逆序(false)查询

返回参数

参数 类型 必有 描述
iotid String 设备标识符
data Object 设备timeline数据
modifytime Long 属性更新时间
property String 属性标识符
batchId String 批次id
timestamp Long 属性采集时间戳

示例

请求示例

{
    "id": "1509086454180",
    "version": "1.0",
    "request": {
        "apiVer": "1.0.2",
        "iotToken": "token"
    },
    "params": {
        "iotId": "D95D242941CE821ECCE4F31A2697",
        "identifier": "xxxx",
        "start": 1517217645000,
        "end": 1517217645000,
        "pageSize": 10,
        "ordered": true
    }
}

正常返回示例

{
  "code": 200,
  "message": "success",
  "localizedMsg": null,
  "data": {
    "items": [
      {
        "iotid": "xqxyZjSKzCwaGdlvbv0O0010851c00",
        "data": 1.23,
        "modifytime": 1511812747287,
        "property": "LightVolt",
        "batchId": "2fc766c5e7064554933ed1f3e4b61803",
        "group": null,
        "timestamp": 1511812747245
      },
      {
        "iotid": "xqxyZjSKzCwaGdlvbv0O0010851c00",
        "data": 1.24,
        "modifytime": 1511812747288,
        "property": "LightVolt",
        "batchId": "2fc766c5e7064554933ed1f3e4b61803",
        "group": null,
        "timestamp": 1511812747245
      }
    ],
    "timestamp": 1511812747245
  }
}

错误码

错误码 错误信息 来源 描述
200 success 系统 成功
400 request error. 系统 请求错误
401 request auth error. 系统 请求认证错误
403 request forbidden. 系统 请求被禁止
404 service not found. 系统 服务未找到
429 too many requests. 系统 太多请求
460 request parameter error. 系统 请求参数错误
500 service error. 系统 服务端错误
503 service not available. 系统 服务不可用

获取物的事件timeline数据

定义描述

path 版本 描述 是否需要用户身份的鉴权
/thing/event/timeline/get 1.0.2 获取物的事件timeline数据 是,客户端SDK需启用身份的鉴权

请求参数

参数 类型 必填 描述
iotId String 物的唯一标识符
identifier String 属性标识符
eventType String 事件类型
start Long timeline起始时间
end Long timeline终止时间
pageSize Int 分页查询条数
ordered Boolean 顺序(true)、逆序(false)查询

返回参数

参数 类型 必有 描述
eventCode String 事件标识符
iotId String 物的唯一标识符
eventName String 事件名称
eventType String 事件类型
eventBody Object 事件参数
batchId String 批次id
timestamp Long 时间采集时间

示例

请求示例

{
    "id": "1509086454180",
    "version": "1.0",
    "request": {
        "apiVer": "1.0.2",
        "iotToken": "token"
    },
    "params": {
        "iotId": "D95D242941CE821ECCE4F31A2697",
        "identifier": "xxxx",
        "eventType": "xxxx",
        "start": 1517217645000,
        "end": 1517217645000,
        "pageSize": 10,
        "ordered": true
    }
}

正常返回示例

{
    "code": 200,
    "message": "success",
    "localizedMsg": "",
    "data": {
        "items": [
            {
                "eventCode": "Error",
                "iotId": "YzqEnI5DY03rxLS2pjjo0010840500",
                "eventName": "故障上报",
                "eventType": "info",
                "eventBody": {
                    "ErrorCode": 0
                },
                "batchId": "5ebc6a9c7d15459f823edde6d28c8fb3",
                "timestamp": 1516342985261
            },
            {
                "eventCode": "Error",
                "iotId": "YzqEnI5DY03rxLS2pjjo0010840500",
                "eventName": "故障上报",
                "eventType": "info",
                "eventBody": {
                    "ErrorCode": 0
                },
                "batchId": "4a0b5a7ac85e470684438d5ff77456f1",
                "timestamp": 1516342995305
            }
        ],
        "timestamp": 1516343075699
    }
}

错误码

错误码 错误信息 来源 描述
200 success 系统 成功
400 request error. 系统 请求错误
401 request auth error. 系统 请求认证错误
403 request forbidden. 系统 请求被禁止
404 service not found. 系统 服务未找到
429 too many requests. 系统 太多请求
460 request parameter error. 系统 请求参数错误
500 service error. 系统 服务端错误
503 service not available. 系统 服务不可用

设置物的属性

定义描述

path 版本 描述 是否需要用户身份的鉴权
/thing/properties/set 1.0.2 设置物的属性 是,客户端SDK需启用身份的鉴权

请求参数

参数 类型 必填 描述
iotId String 物的唯一标识符
items JSON set参数

返回参数

参数 类型 必有 描述

示例

请求示例

{
    "id": "1509086454180",
    "version": "1.0",
    "request": {
        "apiVer": "1.0.2",
        "iotToken": "token"
    },
    "params": {
        "iotId": "D95D242941CE821ECCE4F31A2697",
        "items": {
            "LightSwitch1": 0,
            "LightSwitch2": 0
        }
    }
}

正常返回示例

{
  "code": 200,
  "data": null,
  "message": "success",
  "localizedMsg": ""
}

错误码

错误码 错误信息 来源 描述
200 success 系统 成功
400 request error. 系统 请求错误
401 request auth error. 系统 请求认证错误
403 request forbidden. 系统 请求被禁止
404 service not found. 系统 服务未找到
429 too many requests. 系统 太多请求
460 request parameter error. 系统 请求参数错误
500 service error. 系统 服务端错误
503 service not available. 系统 服务不可用

获取物的事件

定义描述

path 版本 描述 是否需要用户身份的鉴权
/thing/events/get 1.0.2 获取物的事件 是,客户端SDK需启用身份的鉴权

请求参数

参数 类型 必填 描述
iotId String 物的唯一标识符

返回参数

参数 类型 必有 描述
identifier String 事件标识符
time Long 时间采集时间
type String 事件类型
value Object 事件出参

示例

请求示例

{
    "id": "1509086454180",
    "version": "1.0",
    "request": {
        "apiVer": "1.0.2",
        "iotToken": "token"
    },
    "params": {
        "iotId": "D95D242941CE821ECCE4F31A2697"
    }
}

正常返回示例

{
    "code": 200,
    "data": [
        {
            "identifier": "Error",
            "time": 1517420842314,
            "type": "info",
            "value": {
                "Shrink5": 12,
                "Shrink20": {
                    "testKey2": "val2",
                    "testKey": "val"
                }
            }
        }
    ],
    "message": "success",
    "localizedMsg": null
}

错误码

错误码 错误信息 来源 描述
200 success 系统 成功
400 request error. 系统 请求错误
401 request auth error. 系统 请求认证错误
403 request forbidden. 系统 请求被禁止
404 service not found. 系统 服务未找到
429 too many requests. 系统 太多请求
460 request parameter error. 系统 请求参数错误
500 service error. 系统 服务端错误
503 service not available. 系统 服务不可用

根据设备ID获取物的模板

定义描述

path 版本 描述 是否需要用户身份的鉴权
/thing/tsl/get 1.0.2 获取物的tsl功能模板(包含属性、事件、服务的定义) 是,客户端SDK需启用身份的鉴权

请求参数

参数 类型 必填 描述
iotId String 物的唯一标识符

返回参数

参数 类型 必有 描述

示例

请求示例

{
    "id": "1509086454180",
    "version": "1.0",
    "request": {
        "apiVer": "1.0.2",
        "iotToken": "token"
    },
    "params": {
        "iotId": "D95D242941CE821ECCE4F31A2697"
    }
}

正常返回示例

{
    "code": 200,
    "data": {
        "schema": "http://aliyun/iot/thing/desc/schema",
        "profile": {
            "productKey": "a1xqv8AGpck",
            "deviceName": "YzqEnI5DY03rxLS2pjjo"
        },
        "link": "/sys/a1xqv8AGpck/YzqEnI5DY03rxLS2pjjo/thing/",
        "services": [
            {
                "outputData": [

                ],
                "identifier": "set",
                "inputData": [
                    {
                        "identifier": "LightSwitch",
                        "dataType": {
                            "specs": {
                                "0": "关闭",
                                "1": "开启"
                            },
                            "type": "bool"
                        },
                        "name": "主灯开关"
                    },
                    {
                        "identifier": "ColorTemperature",
                        "dataType": {
                            "specs": {
                                "unit": "K",
                                "min": "2700",
                                "unitName": "开尔文",
                                "max": "6500"
                            },
                            "type": "int"
                        },
                        "name": "冷暖色温"
                    },
                    {
                        "identifier": "Brightness",
                        "dataType": {
                            "specs": {
                                "unit": "%",
                                "min": "0",
                                "unitName": "百分比",
                                "max": "100"
                            },
                            "type": "int"
                        },
                        "name": "明暗度"
                    },
                    {
                        "identifier": "HSVColor",
                        "dataType": {
                            "specs": [
                                {
                                    "identifier": "Hue",
                                    "dataType": {
                                        "specs": {
                                            "unit": "°",
                                            "min": "0",
                                            "unitName": "度",
                                            "max": "360"
                                        },
                                        "type": "int"
                                    },
                                    "name": "色调"
                                },
                                {
                                    "identifier": "Saturation",
                                    "dataType": {
                                        "specs": {
                                            "unit": "%",
                                            "min": "0",
                                            "unitName": "百分比",
                                            "max": "100"
                                        },
                                        "type": "int"
                                    },
                                    "name": "饱和度"
                                },
                                {
                                    "identifier": "Value",
                                    "dataType": {
                                        "specs": {
                                            "unit": "%",
                                            "min": "0",
                                            "unitName": "百分比",
                                            "max": "100"
                                        },
                                        "type": "int"
                                    },
                                    "name": "明度"
                                }
                            ],
                            "type": "struct"
                        },
                        "name": "HSV调色"
                    },
                    {
                        "identifier": "HSLColor",
                        "dataType": {
                            "specs": [
                                {
                                    "identifier": "Hue",
                                    "dataType": {
                                        "specs": {
                                            "unit": "°",
                                            "min": "0",
                                            "unitName": "度",
                                            "max": "360"
                                        },
                                        "type": "int"
                                    },
                                    "name": "色调"
                                },
                                {
                                    "identifier": "Saturation",
                                    "dataType": {
                                        "specs": {
                                            "unit": "%",
                                            "min": "0",
                                            "unitName": "百分比",
                                            "max": "100"
                                        },
                                        "type": "int"
                                    },
                                    "name": "饱和度"
                                },
                                {
                                    "identifier": "Lightness",
                                    "dataType": {
                                        "specs": {
                                            "unit": "%",
                                            "min": "0",
                                            "unitName": "百分比",
                                            "max": "100"
                                        },
                                        "type": "int"
                                    },
                                    "name": "亮度"
                                }
                            ],
                            "type": "struct"
                        },
                        "name": "HSL调色"
                    },
                    {
                        "identifier": "RGBColor",
                        "dataType": {
                            "specs": [
                                {
                                    "identifier": "Red",
                                    "dataType": {
                                        "specs": {
                                            "min": "0",
                                            "unitName": "无",
                                            "max": "255"
                                        },
                                        "type": "int"
                                    },
                                    "name": "红色"
                                },
                                {
                                    "identifier": "Green",
                                    "dataType": {
                                        "specs": {
                                            "min": "0",
                                            "unitName": "无",
                                            "max": "255"
                                        },
                                        "type": "int"
                                    },
                                    "name": "绿色"
                                },
                                {
                                    "identifier": "Blue",
                                    "dataType": {
                                        "specs": {
                                            "min": "0",
                                            "unitName": "无",
                                            "max": "255"
                                        },
                                        "type": "int"
                                    },
                                    "name": "蓝色"
                                }
                            ],
                            "type": "struct"
                        },
                        "name": "RGB调色"
                    },
                    {
                        "identifier": "NightLightSwitch",
                        "dataType": {
                            "specs": {
                                "0": "关闭",
                                "1": "开启"
                            },
                            "type": "bool"
                        },
                        "name": "夜灯开关"
                    },
                    {
                        "identifier": "WorkMode",
                        "dataType": {
                            "specs": {
                                "0": "手动",
                                "1": "阅读",
                                "2": "影院",
                                "3": "夜灯",
                                "4": "生活",
                                "5": "柔和"
                            },
                            "type": "enum"
                        },
                        "name": "工作模式"
                    }
                ],
                "method": "thing.service.property.set",
                "name": "set",
                "required": true,
                "callType": "sync",
                "desc": "属性设置"
            },
            {
                "outputData": [
                    {
                        "identifier": "LightSwitch",
                        "dataType": {
                            "specs": {
                                "0": "关闭",
                                "1": "开启"
                            },
                            "type": "bool"
                        },
                        "name": "主灯开关"
                    },
                    {
                        "identifier": "ColorTemperature",
                        "dataType": {
                            "specs": {
                                "unit": "K",
                                "min": "2700",
                                "unitName": "开尔文",
                                "max": "6500"
                            },
                            "type": "int"
                        },
                        "name": "冷暖色温"
                    },
                    {
                        "identifier": "Brightness",
                        "dataType": {
                            "specs": {
                                "unit": "%",
                                "min": "0",
                                "unitName": "百分比",
                                "max": "100"
                            },
                            "type": "int"
                        },
                        "name": "明暗度"
                    },
                    {
                        "identifier": "HSVColor",
                        "dataType": {
                            "specs": [
                                {
                                    "identifier": "Hue",
                                    "dataType": {
                                        "specs": {
                                            "unit": "°",
                                            "min": "0",
                                            "unitName": "度",
                                            "max": "360"
                                        },
                                        "type": "int"
                                    },
                                    "name": "色调"
                                },
                                {
                                    "identifier": "Saturation",
                                    "dataType": {
                                        "specs": {
                                            "unit": "%",
                                            "min": "0",
                                            "unitName": "百分比",
                                            "max": "100"
                                        },
                                        "type": "int"
                                    },
                                    "name": "饱和度"
                                },
                                {
                                    "identifier": "Value",
                                    "dataType": {
                                        "specs": {
                                            "unit": "%",
                                            "min": "0",
                                            "unitName": "百分比",
                                            "max": "100"
                                        },
                                        "type": "int"
                                    },
                                    "name": "明度"
                                }
                            ],
                            "type": "struct"
                        },
                        "name": "HSV调色"
                    },
                    {
                        "identifier": "HSLColor",
                        "dataType": {
                            "specs": [
                                {
                                    "identifier": "Hue",
                                    "dataType": {
                                        "specs": {
                                            "unit": "°",
                                            "min": "0",
                                            "unitName": "度",
                                            "max": "360"
                                        },
                                        "type": "int"
                                    },
                                    "name": "色调"
                                },
                                {
                                    "identifier": "Saturation",
                                    "dataType": {
                                        "specs": {
                                            "unit": "%",
                                            "min": "0",
                                            "unitName": "百分比",
                                            "max": "100"
                                        },
                                        "type": "int"
                                    },
                                    "name": "饱和度"
                                },
                                {
                                    "identifier": "Lightness",
                                    "dataType": {
                                        "specs": {
                                            "unit": "%",
                                            "min": "0",
                                            "unitName": "百分比",
                                            "max": "100"
                                        },
                                        "type": "int"
                                    },
                                    "name": "亮度"
                                }
                            ],
                            "type": "struct"
                        },
                        "name": "HSL调色"
                    },
                    {
                        "identifier": "RGBColor",
                        "dataType": {
                            "specs": [
                                {
                                    "identifier": "Red",
                                    "dataType": {
                                        "specs": {
                                            "min": "0",
                                            "unitName": "无",
                                            "max": "255"
                                        },
                                        "type": "int"
                                    },
                                    "name": "红色"
                                },
                                {
                                    "identifier": "Green",
                                    "dataType": {
                                        "specs": {
                                            "min": "0",
                                            "unitName": "无",
                                            "max": "255"
                                        },
                                        "type": "int"
                                    },
                                    "name": "绿色"
                                },
                                {
                                    "identifier": "Blue",
                                    "dataType": {
                                        "specs": {
                                            "min": "0",
                                            "unitName": "无",
                                            "max": "255"
                                        },
                                        "type": "int"
                                    },
                                    "name": "蓝色"
                                }
                            ],
                            "type": "struct"
                        },
                        "name": "RGB调色"
                    },
                    {
                        "identifier": "NightLightSwitch",
                        "dataType": {
                            "specs": {
                                "0": "关闭",
                                "1": "开启"
                            },
                            "type": "bool"
                        },
                        "name": "夜灯开关"
                    },
                    {
                        "identifier": "WorkMode",
                        "dataType": {
                            "specs": {
                                "0": "手动",
                                "1": "阅读",
                                "2": "影院",
                                "3": "夜灯",
                                "4": "生活",
                                "5": "柔和"
                            },
                            "type": "enum"
                        },
                        "name": "工作模式"
                    }
                ],
                "identifier": "get",
                "inputData": [
                    "LightSwitch",
                    "ColorTemperature",
                    "Brightness",
                    "HSVColor",
                    "HSLColor",
                    "RGBColor",
                    "NightLightSwitch",
                    "WorkMode"
                ],
                "method": "thing.service.property.get",
                "name": "get",
                "required": true,
                "callType": "sync",
                "desc": "属性获取"
            },
            {
                "outputData": [

                ],
                "identifier": "ToggleLightSwitch",
                "inputData": [

                ],
                "method": "thing.service.ToggleLightSwitch",
                "name": "翻转主灯开关",
                "required": false,
                "callType": "async"
            }
        ],
        "properties": [
            {
                "identifier": "LightSwitch",
                "dataType": {
                    "specs": {
                        "0": "关闭",
                        "1": "开启"
                    },
                    "type": "bool"
                },
                "name": "主灯开关",
                "accessMode": "rw",
                "required": true
            },
            {
                "identifier": "ColorTemperature",
                "dataType": {
                    "specs": {
                        "unit": "K",
                        "min": "2700",
                        "unitName": "开尔文",
                        "max": "6500"
                    },
                    "type": "int"
                },
                "name": "冷暖色温",
                "accessMode": "rw",
                "required": false
            },
            {
                "identifier": "Brightness",
                "dataType": {
                    "specs": {
                        "unit": "%",
                        "min": "0",
                        "unitName": "百分比",
                        "max": "100"
                    },
                    "type": "int"
                },
                "name": "明暗度",
                "accessMode": "rw",
                "required": false
            },
            {
                "identifier": "HSVColor",
                "dataType": {
                    "specs": [
                        {
                            "identifier": "Hue",
                            "dataType": {
                                "specs": {
                                    "unit": "°",
                                    "min": "0",
                                    "unitName": "度",
                                    "max": "360"
                                },
                                "type": "int"
                            },
                            "name": "色调"
                        },
                        {
                            "identifier": "Saturation",
                            "dataType": {
                                "specs": {
                                    "unit": "%",
                                    "min": "0",
                                    "unitName": "百分比",
                                    "max": "100"
                                },
                                "type": "int"
                            },
                            "name": "饱和度"
                        },
                        {
                            "identifier": "Value",
                            "dataType": {
                                "specs": {
                                    "unit": "%",
                                    "min": "0",
                                    "unitName": "百分比",
                                    "max": "100"
                                },
                                "type": "int"
                            },
                            "name": "明度"
                        }
                    ],
                    "type": "struct"
                },
                "name": "HSV调色",
                "accessMode": "rw",
                "required": false
            },
            {
                "identifier": "HSLColor",
                "dataType": {
                    "specs": [
                        {
                            "identifier": "Hue",
                            "dataType": {
                                "specs": {
                                    "unit": "°",
                                    "min": "0",
                                    "unitName": "度",
                                    "max": "360"
                                },
                                "type": "int"
                            },
                            "name": "色调"
                        },
                        {
                            "identifier": "Saturation",
                            "dataType": {
                                "specs": {
                                    "unit": "%",
                                    "min": "0",
                                    "unitName": "百分比",
                                    "max": "100"
                                },
                                "type": "int"
                            },
                            "name": "饱和度"
                        },
                        {
                            "identifier": "Lightness",
                            "dataType": {
                                "specs": {
                                    "unit": "%",
                                    "min": "0",
                                    "unitName": "百分比",
                                    "max": "100"
                                },
                                "type": "int"
                            },
                            "name": "亮度"
                        }
                    ],
                    "type": "struct"
                },
                "name": "HSL调色",
                "accessMode": "rw",
                "required": false
            },
            {
                "identifier": "RGBColor",
                "dataType": {
                    "specs": [
                        {
                            "identifier": "Red",
                            "dataType": {
                                "specs": {
                                    "min": "0",
                                    "unitName": "无",
                                    "max": "255"
                                },
                                "type": "int"
                            },
                            "name": "红色"
                        },
                        {
                            "identifier": "Green",
                            "dataType": {
                                "specs": {
                                    "min": "0",
                                    "unitName": "无",
                                    "max": "255"
                                },
                                "type": "int"
                            },
                            "name": "绿色"
                        },
                        {
                            "identifier": "Blue",
                            "dataType": {
                                "specs": {
                                    "min": "0",
                                    "unitName": "无",
                                    "max": "255"
                                },
                                "type": "int"
                            },
                            "name": "蓝色"
                        }
                    ],
                    "type": "struct"
                },
                "name": "RGB调色",
                "accessMode": "rw",
                "required": false
            },
            {
                "identifier": "NightLightSwitch",
                "dataType": {
                    "specs": {
                        "0": "关闭",
                        "1": "开启"
                    },
                    "type": "bool"
                },
                "name": "夜灯开关",
                "accessMode": "rw",
                "required": false
            },
            {
                "identifier": "WorkMode",
                "dataType": {
                    "specs": {
                        "0": "手动",
                        "1": "阅读",
                        "2": "影院",
                        "3": "夜灯",
                        "4": "生活",
                        "5": "柔和"
                    },
                    "type": "enum"
                },
                "name": "工作模式",
                "accessMode": "rw",
                "required": false
            }
        ],
        "events": [
            {
                "outputData": [
                    {
                        "identifier": "LightSwitch",
                        "dataType": {
                            "specs": {
                                "0": "关闭",
                                "1": "开启"
                            },
                            "type": "bool"
                        },
                        "name": "主灯开关"
                    },
                    {
                        "identifier": "ColorTemperature",
                        "dataType": {
                            "specs": {
                                "unit": "K",
                                "min": "2700",
                                "unitName": "开尔文",
                                "max": "6500"
                            },
                            "type": "int"
                        },
                        "name": "冷暖色温"
                    },
                    {
                        "identifier": "Brightness",
                        "dataType": {
                            "specs": {
                                "unit": "%",
                                "min": "0",
                                "unitName": "百分比",
                                "max": "100"
                            },
                            "type": "int"
                        },
                        "name": "明暗度"
                    },
                    {
                        "identifier": "HSVColor",
                        "dataType": {
                            "specs": [
                                {
                                    "identifier": "Hue",
                                    "dataType": {
                                        "specs": {
                                            "unit": "°",
                                            "min": "0",
                                            "unitName": "度",
                                            "max": "360"
                                        },
                                        "type": "int"
                                    },
                                    "name": "色调"
                                },
                                {
                                    "identifier": "Saturation",
                                    "dataType": {
                                        "specs": {
                                            "unit": "%",
                                            "min": "0",
                                            "unitName": "百分比",
                                            "max": "100"
                                        },
                                        "type": "int"
                                    },
                                    "name": "饱和度"
                                },
                                {
                                    "identifier": "Value",
                                    "dataType": {
                                        "specs": {
                                            "unit": "%",
                                            "min": "0",
                                            "unitName": "百分比",
                                            "max": "100"
                                        },
                                        "type": "int"
                                    },
                                    "name": "明度"
                                }
                            ],
                            "type": "struct"
                        },
                        "name": "HSV调色"
                    },
                    {
                        "identifier": "HSLColor",
                        "dataType": {
                            "specs": [
                                {
                                    "identifier": "Hue",
                                    "dataType": {
                                        "specs": {
                                            "unit": "°",
                                            "min": "0",
                                            "unitName": "度",
                                            "max": "360"
                                        },
                                        "type": "int"
                                    },
                                    "name": "色调"
                                },
                                {
                                    "identifier": "Saturation",
                                    "dataType": {
                                        "specs": {
                                            "unit": "%",
                                            "min": "0",
                                            "unitName": "百分比",
                                            "max": "100"
                                        },
                                        "type": "int"
                                    },
                                    "name": "饱和度"
                                },
                                {
                                    "identifier": "Lightness",
                                    "dataType": {
                                        "specs": {
                                            "unit": "%",
                                            "min": "0",
                                            "unitName": "百分比",
                                            "max": "100"
                                        },
                                        "type": "int"
                                    },
                                    "name": "亮度"
                                }
                            ],
                            "type": "struct"
                        },
                        "name": "HSL调色"
                    },
                    {
                        "identifier": "RGBColor",
                        "dataType": {
                            "specs": [
                                {
                                    "identifier": "Red",
                                    "dataType": {
                                        "specs": {
                                            "min": "0",
                                            "unitName": "无",
                                            "max": "255"
                                        },
                                        "type": "int"
                                    },
                                    "name": "红色"
                                },
                                {
                                    "identifier": "Green",
                                    "dataType": {
                                        "specs": {
                                            "min": "0",
                                            "unitName": "无",
                                            "max": "255"
                                        },
                                        "type": "int"
                                    },
                                    "name": "绿色"
                                },
                                {
                                    "identifier": "Blue",
                                    "dataType": {
                                        "specs": {
                                            "min": "0",
                                            "unitName": "无",
                                            "max": "255"
                                        },
                                        "type": "int"
                                    },
                                    "name": "蓝色"
                                }
                            ],
                            "type": "struct"
                        },
                        "name": "RGB调色"
                    },
                    {
                        "identifier": "NightLightSwitch",
                        "dataType": {
                            "specs": {
                                "0": "关闭",
                                "1": "开启"
                            },
                            "type": "bool"
                        },
                        "name": "夜灯开关"
                    },
                    {
                        "identifier": "WorkMode",
                        "dataType": {
                            "specs": {
                                "0": "手动",
                                "1": "阅读",
                                "2": "影院",
                                "3": "夜灯",
                                "4": "生活",
                                "5": "柔和"
                            },
                            "type": "enum"
                        },
                        "name": "工作模式"
                    }
                ],
                "identifier": "post",
                "method": "thing.event.property.post",
                "name": "post",
                "type": "info",
                "required": true,
                "desc": "属性上报"
            },
            {
                "outputData": [
                    {
                        "identifier": "ErrorCode",
                        "dataType": {
                            "specs": {
                                "0": "正常"
                            },
                            "type": "enum"
                        },
                        "name": "故障代码"
                    }
                ],
                "identifier": "Error",
                "method": "thing.event.Error.post",
                "name": "故障上报",
                "type": "info",
                "required": true
            }
        ]
    },
    "message": "success",
    "localizedMsg": null,
    "class": "com.aliyun.iotx.common.base.service.IoTxResult"
}

错误码

错误码 错误信息 来源 描述
200 success 系统 成功
400 request error. 系统 请求错误
401 request auth error. 系统 请求认证错误
403 request forbidden. 系统 请求被禁止
404 service not found. 系统 服务未找到
429 too many requests. 系统 太多请求
460 request parameter error. 系统 请求参数错误
500 service error. 系统 服务端错误
503 service not available. 系统 服务不可用

根据ProductKey获取物的模板

定义描述

path 版本 描述 是否需要用户身份的鉴权
/thing/tsl/getByProducyKey 1.0.2 获取物的tsl功能模板(包含属性、事件、服务的定义) 是,客户端SDK需启用身份的鉴权

请求参数

参数 类型 必填 描述
ProductKey String 产品Key
deviceName String deviceName

返回参数

参数 类型 必有 描述

示例

请求示例

{
    "id": "1509086454180",
    "version": "1.0",
    "request": {
        "apiVer": "1.0.2",
        "iotToken": "token"
    },
    "params": {
        "ProductKey": "xxxxxxxx",
        "deviceName": "xxxxxxxx"
    }
}

正常返回示例

{
    "code": 200,
    "data": {
        "schema": "http://aliyun/iot/thing/desc/schema",
        "profile": {
            "productKey": "a1xqv8AGpck",
            "deviceName": "YzqEnI5DY03rxLS2pjjo"
        },
        "link": "/sys/a1xqv8AGpck/YzqEnI5DY03rxLS2pjjo/thing/",
        "services": [
            {
                "outputData": [

                ],
                "identifier": "set",
                "inputData": [
                    {
                        "identifier": "LightSwitch",
                        "dataType": {
                            "specs": {
                                "0": "关闭",
                                "1": "开启"
                            },
                            "type": "bool"
                        },
                        "name": "主灯开关"
                    },
                    {
                        "identifier": "ColorTemperature",
                        "dataType": {
                            "specs": {
                                "unit": "K",
                                "min": "2700",
                                "unitName": "开尔文",
                                "max": "6500"
                            },
                            "type": "int"
                        },
                        "name": "冷暖色温"
                    },
                    {
                        "identifier": "Brightness",
                        "dataType": {
                            "specs": {
                                "unit": "%",
                                "min": "0",
                                "unitName": "百分比",
                                "max": "100"
                            },
                            "type": "int"
                        },
                        "name": "明暗度"
                    },
                    {
                        "identifier": "HSVColor",
                        "dataType": {
                            "specs": [
                                {
                                    "identifier": "Hue",
                                    "dataType": {
                                        "specs": {
                                            "unit": "°",
                                            "min": "0",
                                            "unitName": "度",
                                            "max": "360"
                                        },
                                        "type": "int"
                                    },
                                    "name": "色调"
                                },
                                {
                                    "identifier": "Saturation",
                                    "dataType": {
                                        "specs": {
                                            "unit": "%",
                                            "min": "0",
                                            "unitName": "百分比",
                                            "max": "100"
                                        },
                                        "type": "int"
                                    },
                                    "name": "饱和度"
                                },
                                {
                                    "identifier": "Value",
                                    "dataType": {
                                        "specs": {
                                            "unit": "%",
                                            "min": "0",
                                            "unitName": "百分比",
                                            "max": "100"
                                        },
                                        "type": "int"
                                    },
                                    "name": "明度"
                                }
                            ],
                            "type": "struct"
                        },
                        "name": "HSV调色"
                    },
                    {
                        "identifier": "HSLColor",
                        "dataType": {
                            "specs": [
                                {
                                    "identifier": "Hue",
                                    "dataType": {
                                        "specs": {
                                            "unit": "°",
                                            "min": "0",
                                            "unitName": "度",
                                            "max": "360"
                                        },
                                        "type": "int"
                                    },
                                    "name": "色调"
                                },
                                {
                                    "identifier": "Saturation",
                                    "dataType": {
                                        "specs": {
                                            "unit": "%",
                                            "min": "0",
                                            "unitName": "百分比",
                                            "max": "100"
                                        },
                                        "type": "int"
                                    },
                                    "name": "饱和度"
                                },
                                {
                                    "identifier": "Lightness",
                                    "dataType": {
                                        "specs": {
                                            "unit": "%",
                                            "min": "0",
                                            "unitName": "百分比",
                                            "max": "100"
                                        },
                                        "type": "int"
                                    },
                                    "name": "亮度"
                                }
                            ],
                            "type": "struct"
                        },
                        "name": "HSL调色"
                    },
                    {
                        "identifier": "RGBColor",
                        "dataType": {
                            "specs": [
                                {
                                    "identifier": "Red",
                                    "dataType": {
                                        "specs": {
                                            "min": "0",
                                            "unitName": "无",
                                            "max": "255"
                                        },
                                        "type": "int"
                                    },
                                    "name": "红色"
                                },
                                {
                                    "identifier": "Green",
                                    "dataType": {
                                        "specs": {
                                            "min": "0",
                                            "unitName": "无",
                                            "max": "255"
                                        },
                                        "type": "int"
                                    },
                                    "name": "绿色"
                                },
                                {
                                    "identifier": "Blue",
                                    "dataType": {
                                        "specs": {
                                            "min": "0",
                                            "unitName": "无",
                                            "max": "255"
                                        },
                                        "type": "int"
                                    },
                                    "name": "蓝色"
                                }
                            ],
                            "type": "struct"
                        },
                        "name": "RGB调色"
                    },
                    {
                        "identifier": "NightLightSwitch",
                        "dataType": {
                            "specs": {
                                "0": "关闭",
                                "1": "开启"
                            },
                            "type": "bool"
                        },
                        "name": "夜灯开关"
                    },
                    {
                        "identifier": "WorkMode",
                        "dataType": {
                            "specs": {
                                "0": "手动",
                                "1": "阅读",
                                "2": "影院",
                                "3": "夜灯",
                                "4": "生活",
                                "5": "柔和"
                            },
                            "type": "enum"
                        },
                        "name": "工作模式"
                    }
                ],
                "method": "thing.service.property.set",
                "name": "set",
                "required": true,
                "callType": "sync",
                "desc": "属性设置"
            },
            {
                "outputData": [
                    {
                        "identifier": "LightSwitch",
                        "dataType": {
                            "specs": {
                                "0": "关闭",
                                "1": "开启"
                            },
                            "type": "bool"
                        },
                        "name": "主灯开关"
                    },
                    {
                        "identifier": "ColorTemperature",
                        "dataType": {
                            "specs": {
                                "unit": "K",
                                "min": "2700",
                                "unitName": "开尔文",
                                "max": "6500"
                            },
                            "type": "int"
                        },
                        "name": "冷暖色温"
                    },
                    {
                        "identifier": "Brightness",
                        "dataType": {
                            "specs": {
                                "unit": "%",
                                "min": "0",
                                "unitName": "百分比",
                                "max": "100"
                            },
                            "type": "int"
                        },
                        "name": "明暗度"
                    },
                    {
                        "identifier": "HSVColor",
                        "dataType": {
                            "specs": [
                                {
                                    "identifier": "Hue",
                                    "dataType": {
                                        "specs": {
                                            "unit": "°",
                                            "min": "0",
                                            "unitName": "度",
                                            "max": "360"
                                        },
                                        "type": "int"
                                    },
                                    "name": "色调"
                                },
                                {
                                    "identifier": "Saturation",
                                    "dataType": {
                                        "specs": {
                                            "unit": "%",
                                            "min": "0",
                                            "unitName": "百分比",
                                            "max": "100"
                                        },
                                        "type": "int"
                                    },
                                    "name": "饱和度"
                                },
                                {
                                    "identifier": "Value",
                                    "dataType": {
                                        "specs": {
                                            "unit": "%",
                                            "min": "0",
                                            "unitName": "百分比",
                                            "max": "100"
                                        },
                                        "type": "int"
                                    },
                                    "name": "明度"
                                }
                            ],
                            "type": "struct"
                        },
                        "name": "HSV调色"
                    },
                    {
                        "identifier": "HSLColor",
                        "dataType": {
                            "specs": [
                                {
                                    "identifier": "Hue",
                                    "dataType": {
                                        "specs": {
                                            "unit": "°",
                                            "min": "0",
                                            "unitName": "度",
                                            "max": "360"
                                        },
                                        "type": "int"
                                    },
                                    "name": "色调"
                                },
                                {
                                    "identifier": "Saturation",
                                    "dataType": {
                                        "specs": {
                                            "unit": "%",
                                            "min": "0",
                                            "unitName": "百分比",
                                            "max": "100"
                                        },
                                        "type": "int"
                                    },
                                    "name": "饱和度"
                                },
                                {
                                    "identifier": "Lightness",
                                    "dataType": {
                                        "specs": {
                                            "unit": "%",
                                            "min": "0",
                                            "unitName": "百分比",
                                            "max": "100"
                                        },
                                        "type": "int"
                                    },
                                    "name": "亮度"
                                }
                            ],
                            "type": "struct"
                        },
                        "name": "HSL调色"
                    },
                    {
                        "identifier": "RGBColor",
                        "dataType": {
                            "specs": [
                                {
                                    "identifier": "Red",
                                    "dataType": {
                                        "specs": {
                                            "min": "0",
                                            "unitName": "无",
                                            "max": "255"
                                        },
                                        "type": "int"
                                    },
                                    "name": "红色"
                                },
                                {
                                    "identifier": "Green",
                                    "dataType": {
                                        "specs": {
                                            "min": "0",
                                            "unitName": "无",
                                            "max": "255"
                                        },
                                        "type": "int"
                                    },
                                    "name": "绿色"
                                },
                                {
                                    "identifier": "Blue",
                                    "dataType": {
                                        "specs": {
                                            "min": "0",
                                            "unitName": "无",
                                            "max": "255"
                                        },
                                        "type": "int"
                                    },
                                    "name": "蓝色"
                                }
                            ],
                            "type": "struct"
                        },
                        "name": "RGB调色"
                    },
                    {
                        "identifier": "NightLightSwitch",
                        "dataType": {
                            "specs": {
                                "0": "关闭",
                                "1": "开启"
                            },
                            "type": "bool"
                        },
                        "name": "夜灯开关"
                    },
                    {
                        "identifier": "WorkMode",
                        "dataType": {
                            "specs": {
                                "0": "手动",
                                "1": "阅读",
                                "2": "影院",
                                "3": "夜灯",
                                "4": "生活",
                                "5": "柔和"
                            },
                            "type": "enum"
                        },
                        "name": "工作模式"
                    }
                ],
                "identifier": "get",
                "inputData": [
                    "LightSwitch",
                    "ColorTemperature",
                    "Brightness",
                    "HSVColor",
                    "HSLColor",
                    "RGBColor",
                    "NightLightSwitch",
                    "WorkMode"
                ],
                "method": "thing.service.property.get",
                "name": "get",
                "required": true,
                "callType": "sync",
                "desc": "属性获取"
            },
            {
                "outputData": [

                ],
                "identifier": "ToggleLightSwitch",
                "inputData": [

                ],
                "method": "thing.service.ToggleLightSwitch",
                "name": "翻转主灯开关",
                "required": false,
                "callType": "async"
            }
        ],
        "properties": [
            {
                "identifier": "LightSwitch",
                "dataType": {
                    "specs": {
                        "0": "关闭",
                        "1": "开启"
                    },
                    "type": "bool"
                },
                "name": "主灯开关",
                "accessMode": "rw",
                "required": true
            },
            {
                "identifier": "ColorTemperature",
                "dataType": {
                    "specs": {
                        "unit": "K",
                        "min": "2700",
                        "unitName": "开尔文",
                        "max": "6500"
                    },
                    "type": "int"
                },
                "name": "冷暖色温",
                "accessMode": "rw",
                "required": false
            },
            {
                "identifier": "Brightness",
                "dataType": {
                    "specs": {
                        "unit": "%",
                        "min": "0",
                        "unitName": "百分比",
                        "max": "100"
                    },
                    "type": "int"
                },
                "name": "明暗度",
                "accessMode": "rw",
                "required": false
            },
            {
                "identifier": "HSVColor",
                "dataType": {
                    "specs": [
                        {
                            "identifier": "Hue",
                            "dataType": {
                                "specs": {
                                    "unit": "°",
                                    "min": "0",
                                    "unitName": "度",
                                    "max": "360"
                                },
                                "type": "int"
                            },
                            "name": "色调"
                        },
                        {
                            "identifier": "Saturation",
                            "dataType": {
                                "specs": {
                                    "unit": "%",
                                    "min": "0",
                                    "unitName": "百分比",
                                    "max": "100"
                                },
                                "type": "int"
                            },
                            "name": "饱和度"
                        },
                        {
                            "identifier": "Value",
                            "dataType": {
                                "specs": {
                                    "unit": "%",
                                    "min": "0",
                                    "unitName": "百分比",
                                    "max": "100"
                                },
                                "type": "int"
                            },
                            "name": "明度"
                        }
                    ],
                    "type": "struct"
                },
                "name": "HSV调色",
                "accessMode": "rw",
                "required": false
            },
            {
                "identifier": "HSLColor",
                "dataType": {
                    "specs": [
                        {
                            "identifier": "Hue",
                            "dataType": {
                                "specs": {
                                    "unit": "°",
                                    "min": "0",
                                    "unitName": "度",
                                    "max": "360"
                                },
                                "type": "int"
                            },
                            "name": "色调"
                        },
                        {
                            "identifier": "Saturation",
                            "dataType": {
                                "specs": {
                                    "unit": "%",
                                    "min": "0",
                                    "unitName": "百分比",
                                    "max": "100"
                                },
                                "type": "int"
                            },
                            "name": "饱和度"
                        },
                        {
                            "identifier": "Lightness",
                            "dataType": {
                                "specs": {
                                    "unit": "%",
                                    "min": "0",
                                    "unitName": "百分比",
                                    "max": "100"
                                },
                                "type": "int"
                            },
                            "name": "亮度"
                        }
                    ],
                    "type": "struct"
                },
                "name": "HSL调色",
                "accessMode": "rw",
                "required": false
            },
            {
                "identifier": "RGBColor",
                "dataType": {
                    "specs": [
                        {
                            "identifier": "Red",
                            "dataType": {
                                "specs": {
                                    "min": "0",
                                    "unitName": "无",
                                    "max": "255"
                                },
                                "type": "int"
                            },
                            "name": "红色"
                        },
                        {
                            "identifier": "Green",
                            "dataType": {
                                "specs": {
                                    "min": "0",
                                    "unitName": "无",
                                    "max": "255"
                                },
                                "type": "int"
                            },
                            "name": "绿色"
                        },
                        {
                            "identifier": "Blue",
                            "dataType": {
                                "specs": {
                                    "min": "0",
                                    "unitName": "无",
                                    "max": "255"
                                },
                                "type": "int"
                            },
                            "name": "蓝色"
                        }
                    ],
                    "type": "struct"
                },
                "name": "RGB调色",
                "accessMode": "rw",
                "required": false
            },
            {
                "identifier": "NightLightSwitch",
                "dataType": {
                    "specs": {
                        "0": "关闭",
                        "1": "开启"
                    },
                    "type": "bool"
                },
                "name": "夜灯开关",
                "accessMode": "rw",
                "required": false
            },
            {
                "identifier": "WorkMode",
                "dataType": {
                    "specs": {
                        "0": "手动",
                        "1": "阅读",
                        "2": "影院",
                        "3": "夜灯",
                        "4": "生活",
                        "5": "柔和"
                    },
                    "type": "enum"
                },
                "name": "工作模式",
                "accessMode": "rw",
                "required": false
            }
        ],
        "events": [
            {
                "outputData": [
                    {
                        "identifier": "LightSwitch",
                        "dataType": {
                            "specs": {
                                "0": "关闭",
                                "1": "开启"
                            },
                            "type": "bool"
                        },
                        "name": "主灯开关"
                    },
                    {
                        "identifier": "ColorTemperature",
                        "dataType": {
                            "specs": {
                                "unit": "K",
                                "min": "2700",
                                "unitName": "开尔文",
                                "max": "6500"
                            },
                            "type": "int"
                        },
                        "name": "冷暖色温"
                    },
                    {
                        "identifier": "Brightness",
                        "dataType": {
                            "specs": {
                                "unit": "%",
                                "min": "0",
                                "unitName": "百分比",
                                "max": "100"
                            },
                            "type": "int"
                        },
                        "name": "明暗度"
                    },
                    {
                        "identifier": "HSVColor",
                        "dataType": {
                            "specs": [
                                {
                                    "identifier": "Hue",
                                    "dataType": {
                                        "specs": {
                                            "unit": "°",
                                            "min": "0",
                                            "unitName": "度",
                                            "max": "360"
                                        },
                                        "type": "int"
                                    },
                                    "name": "色调"
                                },
                                {
                                    "identifier": "Saturation",
                                    "dataType": {
                                        "specs": {
                                            "unit": "%",
                                            "min": "0",
                                            "unitName": "百分比",
                                            "max": "100"
                                        },
                                        "type": "int"
                                    },
                                    "name": "饱和度"
                                },
                                {
                                    "identifier": "Value",
                                    "dataType": {
                                        "specs": {
                                            "unit": "%",
                                            "min": "0",
                                            "unitName": "百分比",
                                            "max": "100"
                                        },
                                        "type": "int"
                                    },
                                    "name": "明度"
                                }
                            ],
                            "type": "struct"
                        },
                        "name": "HSV调色"
                    },
                    {
                        "identifier": "HSLColor",
                        "dataType": {
                            "specs": [
                                {
                                    "identifier": "Hue",
                                    "dataType": {
                                        "specs": {
                                            "unit": "°",
                                            "min": "0",
                                            "unitName": "度",
                                            "max": "360"
                                        },
                                        "type": "int"
                                    },
                                    "name": "色调"
                                },
                                {
                                    "identifier": "Saturation",
                                    "dataType": {
                                        "specs": {
                                            "unit": "%",
                                            "min": "0",
                                            "unitName": "百分比",
                                            "max": "100"
                                        },
                                        "type": "int"
                                    },
                                    "name": "饱和度"
                                },
                                {
                                    "identifier": "Lightness",
                                    "dataType": {
                                        "specs": {
                                            "unit": "%",
                                            "min": "0",
                                            "unitName": "百分比",
                                            "max": "100"
                                        },
                                        "type": "int"
                                    },
                                    "name": "亮度"
                                }
                            ],
                            "type": "struct"
                        },
                        "name": "HSL调色"
                    },
                    {
                        "identifier": "RGBColor",
                        "dataType": {
                            "specs": [
                                {
                                    "identifier": "Red",
                                    "dataType": {
                                        "specs": {
                                            "min": "0",
                                            "unitName": "无",
                                            "max": "255"
                                        },
                                        "type": "int"
                                    },
                                    "name": "红色"
                                },
                                {
                                    "identifier": "Green",
                                    "dataType": {
                                        "specs": {
                                            "min": "0",
                                            "unitName": "无",
                                            "max": "255"
                                        },
                                        "type": "int"
                                    },
                                    "name": "绿色"
                                },
                                {
                                    "identifier": "Blue",
                                    "dataType": {
                                        "specs": {
                                            "min": "0",
                                            "unitName": "无",
                                            "max": "255"
                                        },
                                        "type": "int"
                                    },
                                    "name": "蓝色"
                                }
                            ],
                            "type": "struct"
                        },
                        "name": "RGB调色"
                    },
                    {
                        "identifier": "NightLightSwitch",
                        "dataType": {
                            "specs": {
                                "0": "关闭",
                                "1": "开启"
                            },
                            "type": "bool"
                        },
                        "name": "夜灯开关"
                    },
                    {
                        "identifier": "WorkMode",
                        "dataType": {
                            "specs": {
                                "0": "手动",
                                "1": "阅读",
                                "2": "影院",
                                "3": "夜灯",
                                "4": "生活",
                                "5": "柔和"
                            },
                            "type": "enum"
                        },
                        "name": "工作模式"
                    }
                ],
                "identifier": "post",
                "method": "thing.event.property.post",
                "name": "post",
                "type": "info",
                "required": true,
                "desc": "属性上报"
            },
            {
                "outputData": [
                    {
                        "identifier": "ErrorCode",
                        "dataType": {
                            "specs": {
                                "0": "正常"
                            },
                            "type": "enum"
                        },
                        "name": "故障代码"
                    }
                ],
                "identifier": "Error",
                "method": "thing.event.Error.post",
                "name": "故障上报",
                "type": "info",
                "required": true
            }
        ]
    },
    "message": "success",
    "localizedMsg": null,
    "class": "com.aliyun.iotx.common.base.service.IoTxResult"
}

错误码

错误码 错误信息 来源 描述
200 success 系统 成功
400 request error. 系统 请求错误
401 request auth error. 系统 请求认证错误
403 request forbidden. 系统 请求被禁止
404 service not found. 系统 服务未找到
429 too many requests. 系统 太多请求
460 request parameter error. 系统 请求参数错误
500 service error. 系统 服务端错误
503 service not available. 系统 服务不可用

获取物的属性

定义描述

path 版本 描述 是否需要用户身份的鉴权
/thing/properties/get 1.0.2 获取物的所有属性快照数据 是,客户端SDK需启用身份的鉴权

请求参数

参数 类型 必填 描述
iotId String 物的标识符

返回参数

参数 类型 必有 描述
value Object 属性对应的数据
time Long 属性采集时间

示例

请求示例

{
    "id": "1509086454180",
    "version": "1.0",
    "request": {
        "apiVer": "1.0.2",
        "iotToken": "token"
    },
    "params": {
        "iotId": "D95D242941CE821ECCE4F31A2697"
    }
}

正常返回示例

{
  "code": 200,
  "data": {
    "_sys_device_mid": {
      "time": 1516356290173,
      "value": "example.demo.module-id"
    },
    "WorkMode": {
      "time": 1516347450295,
      "value": 0
    },
    "_sys_device_pid": {
      "time": 1516356290173,
      "value": "example.demo.partner-id"
    }
  },
  "message": "success",
  "localizedMsg": null
}

错误码

错误码 错误信息 来源 描述
200 success 系统 成功
400 request error. 系统 请求错误
401 request auth error. 系统 请求认证错误
403 request forbidden. 系统 请求被禁止
404 service not found. 系统 服务未找到
429 too many requests. 系统 太多请求
460 request parameter error. 系统 请求参数错误
500 service error. 系统 服务端错误
503 service not available. 系统 服务不可用

触发物的服务

定义描述

path 版本 描述 是否需要用户身份的鉴权
/thing/service/invoke 1.0.2 触发物的服务 是,客户端SDK需启用身份的鉴权

请求参数

参数 类型 必填 描述
iotId String 物的标识符
identifier String 服务标识符
args JSON 服务入参

返回参数

参数 类型 必有 描述
data Object 该返回值类型及值取决于设备端实现逻辑

示例

请求示例

{
    "id": "1509086454180",
    "version": "1.0",
    "request": {
        "apiVer": "1.0.2",
        "iotToken": "token"
    },
    "params": {
        "iotId": "D95D242941CE821ECCE4F31A2697",
        "identifier": "xxxx",
        "args": {}
    }
}

正常返回示例

{
  "code": 200,
  "data": null,
  "message": "success",
  "localizedMsg": ""
}

错误码

错误码 错误信息 来源 描述
200 success 系统 成功
400 request error. 系统 请求错误
401 request auth error. 系统 请求认证错误
403 request forbidden. 系统 请求被禁止
404 service not found. 系统 服务未找到
429 too many requests. 系统 太多请求
460 request parameter error. 系统 请求参数错误
500 service error. 系统 服务端错误
503 service not available. 系统 服务不可用

获取物的连接状态

定义描述

path 版本 描述 是否需要用户身份的鉴权
/thing/status/get 1.0.2 获取物的连接状态 是,客户端SDK需启用身份的鉴权

请求参数

参数 类型 必填 描述
iotId String 物的唯一标识符

返回参数

参数 类型 必有 描述
status Integer 设备状态 0 - 未激活,1-在线, 3 - 离线, 8 - 禁用
time Long 状态变更时间

示例

请求示例

{
    "id": "1509086454180",
    "version": "1.0",
    "request": {
        "apiVer": "1.0.2",
        "iotToken": "token"
    },
    "params": {
        "iotId": "D95D242941CE821ECCE4F31A2697"
    }
}

正常返回示例

{
  "code": 200,
  "data": {
    "time": 1517923297000,
    "status": 3
  },
  "message": "success",
  "localizedMsg": null,
}

错误码

错误码 错误信息 来源 描述
200 success 系统 成功
400 request error. 系统 请求错误
401 request auth error. 系统 请求认证错误
403 request forbidden. 系统 请求被禁止
404 service not found. 系统 服务未找到
429 too many requests. 系统 太多请求
460 request parameter error. 系统 请求参数错误
500 service error. 系统 服务端错误
503 service not available. 系统 服务不可用

设置设备扩展信息

定义描述

path 版本 描述 是否需要用户身份的鉴权
/thing/extended/property/set 1.0.2 设置物的扩展属性数据 是,客户端SDK需启用身份的鉴权

请求参数

参数 类型 必填 描述
iotId String 物的唯一标识符
dataKey String 扩展属性标识符
dataValue Long 扩展属性的值

返回参数

参数 类型 必有 描述

示例

请求示例

{
    "id": "1509086454180",
    "version": "1.0",
    "request": {
        "apiVer": "1.0.2",
        "iotToken": "token"
    },
    "params": {
        "iotId": "D95D242941CE821ECCE4F31A2697",
        "dataKey": "xxxx",
        "dataValue": "xxxx"
    }
}

正常返回示例

{
  "code": 200,
  "message": "success",
  "localizedMsg": null,
  "data": null
}

错误码

错误码 错误信息 来源 描述
200 success 系统 成功
400 request error. 系统 请求错误
401 request auth error. 系统 请求认证错误
403 request forbidden. 系统 请求被禁止
404 service not found. 系统 服务未找到
429 too many requests. 系统 太多请求
460 request parameter error. 系统 请求参数错误
500 service error. 系统 服务端错误
503 service not available. 系统 服务不可用

获取设备扩展信息

定义描述

path 版本 描述 是否需要用户身份的鉴权
/thing/extended/property/get 1.0.2 获取物的扩展属性的数据 是,客户端SDK需启用身份的鉴权

请求参数

参数 类型 必填 描述
iotId String 物的唯一标识符
dataKey String 扩展属性标识符

返回参数

参数 类型 必有 描述
data String 扩展属性的值

示例

请求示例

{
    "id": "1509086454180",
    "version": "1.0",
    "request": {
        "apiVer": "1.0.2",
        "iotToken": "token"
    },
    "params": {
        "iotId": "D95D242941CE821ECCE4F31A2697",
        "dataKey": "xxxx"
    }
}

正常返回示例

{
  "code": 200,
  "message": "success",
  "localizedMsg": null,
  "data": "xxxx"
}

错误码

错误码 错误信息 来源 描述
200 success 系统 成功
400 request error. 系统 请求错误
401 request auth error. 系统 请求认证错误
403 request forbidden. 系统 请求被禁止
404 service not found. 系统 服务未找到
429 too many requests. 系统 太多请求
460 request parameter error. 系统 请求参数错误
500 service error. 系统 服务端错误
503 service not available. 系统 服务不可用

results matching ""

    No results matching ""