文档中心 / 教程

设备接入快速上手

约 15 分钟，从设备通电到读出第一个设施值、下发第一条控制指令。

1. 第 1 步 · 通电并确认联网

   水阀接入 DC 12V 电源、传感器装入锂亚电池；观察指示灯——慢闪表示正在搜索 4G 网络，快闪表示已联网。

2. 第 2 步 · 微信扫码绑定设备

   扫描设备外壳上的二维码；首次会提示未授权登录，阅读协议后点击微信图标授权，再扫一次即完成绑定。

3. 第 3 步 · 在「云智联YZL」小程序生成 API Token

   打开小程序 →「我的」→「开放接口」→ 生成访问密钥（Token）。该 Token 可访问账号下所有设备，请妥善保管。

4. 第 4 步 · 读取设备与设施（测点）

   调用 GET /open/device/list 拿到设备列表与设施集，记录 facilitys[].id 与 key（wd / sf / kk1 / yw）。请求头带上 YZLIOT-APIKEY。

5. 第 5 步 · 读历史值或下发指令

   读历史：GET /open/history?facilityId=…&StartTime=…&EndTime=…；开阀：POST /open/command/send，type 用 SetFac、args 传 [设备ID, "kk1", "1"]。

完整接口清单见 开放 API v2 接口文档； 需要联调支持请 联系我们。