快速开始

根据当前验证目标选择最短路径。如果只是确认凭证和设备访问是否可用，先完成两条 curl 请求；需要完整引导时再使用 Bruno。

选择验证方式

2 分钟快速验证

使用两条 curl 请求获取 access token 并查询设备列表，不需要安装集合或 SDK。

使用 curl 验证

完整验证

使用 Bruno 集合验证认证、设备查询、实时状态和可选控制。

使用 Bruno 验证

服务端接入

验证成功后，在后端接入 TypeScript、Python 或 Go SDK。

接入 SDK

需要准备

• API Client 的 clientId 和 clientSecret
• device:read 权限
• 如果希望设备列表返回数据，账号下需要有 API Client 可访问的设备

还没有凭证时，先阅读获取 API Key。没有真实硬件时，可联系 support@svnwi.com 申请测试凭据。

凭证只能保存在服务端

WLTE OpenAPI 面向服务端接入。不要把 clientSecret 放入浏览器代码、移动端应用、公开仓库或公开日志。

推荐顺序

1. 先完成 curl 快速验证，确认凭证和设备访问正常。
2. 需要查看实时状态或安全验证命令时，再使用 Bruno。
3. 把已经验证的流程迁移到 SDK 或自己的服务端代码。
4. 通过集成指南继续设计生产架构。

请求失败时，查看常见失败。