通过调用该接口,根据设备ID获取物的TSL功能模板,包含属性、事件、服务的定义。

路径 /thing/tsl/get
版本号 1.0.4
协议 HTTP,HTTPS
请求方法 POST
是否需要用户身份鉴权
超时时间 3000

请求参数

名称 类型 是否必选 示例值 描述
iotId String 设备ID,生活物联网平台为设备颁发的ID,设备的唯一标识符。
origin String 调用来源。
userType String 账号类型:"TAOBAO" 、"ALIPAY" 。
userId String 账号ID。

返回数据

名称 类型 示例值 描述
data String

物的模板ISON对象。

示例

请求示例

{
	"id": "1509086454180",
	"version": "1.0",
	"request":{
		"apiVer": "1.0.4",
		"iotToken": "token"
	},
	"params":{
		"iotId": "value0",
		"origin": "value1",
		"userType": "value2",
		"userId": "value3"
	}
}

正常返回示例

JSON 格式

{
 "code": 200,
    "data": {
        "schema": "http://aliyun/iot/thing/desc/schema",
        "profile": {
            "productKey": "xxxxxxx",
            "deviceName": "xxxxxxxxxxxxxxxx"
        },
        "link": "/sys/a1xxxxpck/YzqEnxxxx2pjjo/thing/",
        "services": [
            {
                "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
            }
        ],
        "events": [
            {
                "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
}

异常返回示例

JSON 格式

{}