API 文档
接口处于分阶段建设中。本页先提供稳定的安全约定;尚未公开的资源不会提供可调用示例。涵盖认证、权限、设备授权和自动化接入说明。
通用约定
- 所有公开请求使用 HTTPS 与版本化路径。
- 控制动作必须经过 scope、组织、设备授权和策略校验。
- 失败响应包含稳定错误码与 request_id,便于审计和排障。
文档目录
- 概览:版本策略、请求约定与支持状态。
- 认证与授权:OAuth 应用、短期访问令牌、scope 和设备授权。
- 设备与会话:读取已授权设备、提交连接申请、查询状态。
- 自动化任务:项目、发布包、设备能力、运行与取消。
- Webhook 与审计:事件签名、失败投递与可追溯审计。