第五部分外部连接
第14章

集成令牌与 API

想把传感器数据接到自己的系统、自动化的表格或某个合作应用里吗?Integrations(集成)菜单可以创建访问令牌 —— 这种钥匙只授予读取某一台设备传感器的权限,而不必把账户交出去。

14.1 创建令牌

  1. 在侧边菜单中打开 Integrations,点击 Add(添加)。
  2. 给令牌起一个名称 —— 比如将要使用它的服务名。
  3. 如果需要,可以设置密码有效期(最长 10 年,或永不过期)。
  4. 选择对应的设备 —— 一个令牌只授予一台设备的访问权限。
  5. 保存,并用 Copy(复制)按钮把令牌带到目标服务中。

列表会显示有效的令牌,包含创建时间、有效期,以及 Edit(编辑)和 Revoke(吊销)两项操作 —— 吊销会立刻切断访问,且不影响其他任何东西。

14.2 传感器 API

令牌授予的是 Aquarino 云端读取接口的访问权限:

  • GET cloud.aquarino.com.br/api/integrations/sensors,令牌放在 Authorization: Bearer 请求头中;
  • 返回内容包含设备、固件,以及带数值和单位的传感器列表;
  • 每个令牌限制为每小时 12 次调用 —— 建议每 15 分钟调用一次,这与数据的刷新节奏相匹配。