通过云端开放平台向超级屏下发命令、查询设备、订阅事件。命令体与《命令》册完全一致。
下发命令

请求地址:http(s)://api.thingboot.com/{AppID}/order/?sign={sign}&ts={ts}(或 MQTT 主题 api/{AppID}/order)。参数与返回见平台接口文档「向设备下发指令」。

对超级屏而言,order 的内容就是命令包装键:

常用业务场景
场景命令
门店海报上屏web 下发图片/海报页 URL(mp4 视频给直链)
定时切换内容你的调度系统按计划下发不同的 web
分屏混排screen add/update 划分区域后,分别 web
打烊清屏{"screen":{"action":"clear"}}
到店欢迎speech 下发欢迎文本
插件投放plugin 下发插件 slug + vars(见《插件》册)
查询与事件订阅
  • 设备信息/网络/状态:{"system":"info"} / {"system":"network"} / {"system":"state"};
  • 区域布局与当前内容:{"screen":{"action":"list"}}、{"web":{"area":"a5"}}(查询类命令直接返回数据);
  • 设备事件(上下线、区域开关、布局变化、页面自定义事件、本地设置变更)经平台消息推送订阅,机制见「平台接口文档」的消息推送部分;
  • OTA 升级按平台固件 OTA 流程执行,按本产品 productKey 区分产物。
注意事项
  • 多设备可同时下发(device 参数支持间隔符多选),但要求这些设备属于同一产品;
  • 命令应答经原通道异步返回并携带原 mid,请在你的系统里做好请求-应答关联与超时处理;
  • 下发频率建议控制在每秒数次以内,避免给设备与通道造成压力。
接口站端点(app.thingboot.com/screen/,遥控器/插件生态用)

与开放平台 AppID 体系并列的一组 HTTPS 端点,供遥控器页面与插件生态使用。鉴权二选一:?token= 登录令牌(Authorization: Bearer 头亦可)或 ?code= 设备控制码;JSON 返回 {"code","data","msg"}。

端点说明
GET device/channel/?id=云控通道信息(Pusher 连接参数 + 控制码开关 + 在线状态)
POST device/config/?id=配置读写(names 批量读 / fetch 全量读 / write 写)
POST device/system/?id=系统操作(转工作台 bench / 重新注册 reg / 重启 restart / 模式 mode)
GET device/info/?id=读设备名称与备注(控制码或登录鉴权)
POST device/rename/?id=改设备名称/备注(name 4~32 位,中文/英文/数字/_-;remark 空串=清空)
POST auth/control/Pusher 遥控通道鉴权(bench 归属免码,否则校验控制码)
GET plugin/show/<slug>/插件显示页(UA 含 SuperScreen/ 或带 ?preview=1 才给内容)
GET plugin/panel/?id=插件控制面板页(DATA 变化经 postMessage 推给父页,跨域取参数用)
GET plugin/list/插件市场列表(已上架;含 id/slug/title/icon/orient/has_panel/update_time)
GET plugin/my/我的插件列表(需登录 token,返回当前用户的插件)
GET tts/sources/语音模型补充下载源列表

登录令牌经 POST /user/login/ 获取(账号 + md5 密码 + 客户端设备标识;设备标识由 POST /user/device/register/ 签发)。