设备数据与控制

查看设备最新属性、调用服务（开关等控制的底层通道）、查询历史数据与物模型定义。前缀：/app-api/iot/app-user-device，均需登录态。

获取设备最新属性

方法	接口地址
GET	/app-api/iot/app-user-device/lastProps/{deviceId}

响应参数（data.list 每项）：name（属性名）、identifier（标识符）、value（最新值，类型取决于物模型 dataType）、dataType、ts（时间）、accessMode（读写权限）、tags（枚举/布尔描述符 JSON）。

查询设备服务列表

方法	接口地址
GET	/app-api/iot/app-user-device/services/{deviceId}

响应参数（data.list 每项）：name、identifier、callType（1：同步；2：异步）、inputParams / outputParams（JSON 字符串）、block。

调用设备服务（设备控制）

方法	接口地址
POST	/app-api/iot/app-user-device/invokeService/{deviceId}

请求参数（body）

参数名称	参数说明	是否必须	数据类型
identifier	服务唯一标识（开关类控制即对应服务的 identifier）	true	string
block	功能模块标识，默认模块不传	false	string
inputParams	服务入参键值对，如 {"Power": 1}	false	map

响应参数：data 恒为 null；同步调用的设备回复写入服务调用记录。设备离线时报错（2011000001），同步调用超时（10 秒）报 2011000003。

App 端属性开关控制的实现方式：物模型为属性定义一个「设置类服务」（如 set_power），App 通过本接口调用该服务完成控制。

历史数据分页（属性 / 服务 / 事件）

数据	URL（GET）	特有 query 参数
属性历史	/propLogPage/{deviceId}	identifier（必填）、block
服务调用记录	/serviceLogPage/{deviceId}	identifier、callType、block、messageId
事件记录	/eventPage/{deviceId}	identifier、eventType（1：info；2：warn；3：error）、block

公共 query 参数：pageNo / pageSize / startTime / endTime（13 位时间戳）。响应 data 为分页结构（list/total）。

查询产品物模型定义

用于场景自动化配置时选择属性/事件/服务：

URL（GET）	说明
/tslProperties/list/{productKey}	产品全部属性定义
/tslProperties/canWrite/list/{productKey}	仅可写属性（用于属性设置类动作）
/tslServices/list/{productKey}	产品全部服务定义
/tslEvents/list/{productKey}	产品全部事件定义

查询设备本地日志

方法	接口地址
GET	/app-api/iot/local-log/page/{deviceId}

请求参数（query）：pageNo / pageSize（必填），module、traceContext、code、logLevel（FATAL|ERROR|WARN|INFO|DEBUG|OTHER）、logContent 可选。

响应参数（data.list 每项）：ts、module、traceContext、code、logLevel、logContent。