SuperAPI AI 工具集

dot-skill

编程与开发

查看项目

更新于 10-16 01:16

技能介绍

用途:Dot Skill 用于通过 HTTP OpenAPI 远程操控 Dot. 设备,例如在电子墨水屏上显示文本、图片或自定义 Canvas 布局,查询设备状态,列出设备及管理设备内容。

主要能力:提供设备管理接口(列出设备、查询状态、切换下一内容、列出任务)与内容控制接口(文本、图像、Canvas 布局)。文本接口支持标题、正文、签名、图标、链接及字体样式覆盖;图像接口接收 PNG Base64 或 http(s) 图片 URL,并可设置抖动算法与边框;Canvas 接口用类 React 的对象树和 Tailwind 风格类构建自定义卡片、仪表盘或状态面板。

使用方式:基础 URL 为 https://dot.mindreset.tech,请求头需携带 Authorization: Bearer dot_app_<your_api_key>。API Key 从 Dot. App 的 More → API Keys 获取,设备 ID 从 Dot. App 的 Device → Device Serial Number 获取,也可使用环境变量 DOT_API_KEY。调用文本、图像或 Canvas 写入前,对应内容必须已添加到 Dot. App Content Studio 中该设备的循环任务。POST 请求需 Content-Type: application/json。

限制:速率限制每秒 10 次;Canvas 仅支持 div、span、img 三类元素,禁止 JSX、原始 HTML、外部 CSS、脚本、自定义组件、任意 JS 表达式与复杂计算;有明确的 JSON 大小、元素数量、嵌套深度和字符串长度上限。响应以 HTTP 状态码作为结果,成功响应仅含顶层 message 字段,不再使用 { code, message, result } 包装。401 表示 API Key 无效,404 表示设备未找到,429 表示超出速率限制。API Key 与设备 ID 不可默认已提供,需向用户询问。