定义¶

Sentino IoT 平台的 App 端 HTTP API，涵盖用户认证、配网、设备管理和智能体管理，共 22 个接口。基础 URL 为 https://api-iot.sentino.jp。

设计哲学：面向终端直调¶

这套 API 是面向终端（App/设备）直接调用的，不是给开发者在服务端集成调用的。公共请求头（client_id、app_id、package_name、channel_identifier）全部是移动端 App 标识符，认证方式是 UID（终端用户身份）而非开发者 API Key。

这意味着 Sentino 是全栈产品而非开发者平台——品牌方的 App 直接调 Sentino 云，中间没有开发者自己的后端。安全上，每个请求来自不可信环境，API 返回值应假设会被逆向。

见 sentino-iot "架构定位"一节。

关键要点¶

• 认证方式：UID 授权（注册登录合一），登录获取 Bearer Token（约 30 天有效期）
• 公共请求头：所有接口（含登录）必须携带 client_id、app_id、channel_identifier、package_name、encrypt_type、timezone、language、data_center_code
• 主要接口分组：
• 认证：用户登录（POST /auth/oauth/token）
• 配网：产品信息查询、配网数据加密、绑定状态查询、数据中心列表
• 设备管理：账户 ID 获取（assetTree）、设备信息/列表、OTA 检查、解绑
• 智能体管理：推荐列表、详情、自定义创建/删除、绑定到设备、NFC 卡片管理
• 关键注意：assetTree 接口返回的字段名为 id（非 assetId），子节点字段为 childrens（非 children）
• 绑定状态查询：轮询 checkBindResult/{uuid}，data=0 表示绑定成功

相关概念¶

• sentino-iot
• ai-intelligent-agent
• device-lifecycle