开发者文档（API 简介）

面向集成商与二次开发工程师，OpenAPI 完整文档位于业务系统租户后台（app.dtwince.cloud）。

认证方式

• 租户管理员在后台生成 API Key；
• 请求头携带 Authorization: Bearer <API_KEY>；
• 接口返回统一 JSON 格式。

常用接口

场景管理

方法	路径	说明
GET	/api/v1/scenes	场景列表
POST	/api/v1/scenes	创建场景
GET	/api/v1/scenes/:id	场景详情
PUT	/api/v1/scenes/:id	更新场景

设备数据

方法	路径	说明
GET	/api/v1/iot/devices	设备列表
POST	/api/v1/iot/publish	发布设备数据

大屏页面

方法	路径	说明
GET	/api/v1/pages	页面列表
POST	/api/v1/pages/:id/publish	发布页面

数据源对接

支持 Webhook 推送、MQTT 订阅、数据库直连三种方式将业务数据接入孪生场景。

沙箱密钥与完整 API 文档请登录业务系统租户后台获取。