第五部分外部连接
第14章
集成令牌与 API
想把传感器数据接到自己的系统、自动化的表格或某个合作应用里吗?Integrations(集成)菜单可以创建访问令牌 —— 这种钥匙只授予读取某一台设备传感器的权限,而不必把账户交出去。
14.1 创建令牌
- 在侧边菜单中打开 Integrations,点击 Add(添加)。
- 给令牌起一个名称 —— 比如将要使用它的服务名。
- 如果需要,可以设置密码和有效期(最长 10 年,或永不过期)。
- 选择对应的设备 —— 一个令牌只授予一台设备的访问权限。
- 保存,并用 Copy(复制)按钮把令牌带到目标服务中。
列表会显示有效的令牌,包含创建时间、有效期,以及 Edit(编辑)和 Revoke(吊销)两项操作 —— 吊销会立刻切断访问,且不影响其他任何东西。
14.2 传感器 API
令牌授予的是 Aquarino 云端读取接口的访问权限:
GET cloud.aquarino.com.br/api/integrations/sensors,令牌放在Authorization: Bearer请求头中;- 返回内容包含设备、固件,以及带数值和单位的传感器列表;
- 每个令牌限制为每小时 12 次调用 —— 建议每 15 分钟调用一次,这与数据的刷新节奏相匹配。