设备影子与定时任务

App 端通过设备影子的 desired.CRON_JOB 字段管理设备的本地定时任务（如每天 21:00 自动关机，由设备端离线执行）。前缀：/app-api/iot/shadow，均需登录态。

获取设备影子

方法	接口地址
GET	/app-api/iot/shadow/get?deviceId=

响应参数（data）

参数名称	参数说明	数据类型
shadow	影子JSON字符串，含 state.reported / state.desired（CRON_JOB 存于 desired）	string
deviceId / deviceName / productKey / productId	设备与产品标识	-
updateTime	最近更新时间	string

影子格式说明见设备影子。

更新设备定时任务

方法	接口地址
PUT	/app-api/iot/shadow/updateJob

请求参数（body）

参数名称	参数说明	是否必须	数据类型
deviceId	设备id	true	long
cronJob	定时任务JSON数组，服务端校验 cron 表达式合法与 identifier 非空	true	string

cronJob 格式示例（每天 21:00 执行开/关机服务）：

[
  { "cron": "0 0 21 ? * 1-7", "identifier": "open_service" },
  { "cron": "0 0 22 ? * 1-7", "identifier": "close_service" }
]

identifier 为物模型服务标识。更新成功后平台向在线设备推送影子 control 消息，设备据此覆盖本地定时任务；设备离线时上线后通过拉取影子对齐。