# io.net 读取凭据如何保存：7 天、仅服务器、断开即删

登录后提交 Bearer 令牌。保存前必须能读到你填写的那台设备。凭据加密存放最多 7 天，一个账户一条 io.net 连接。成功读取一台设备不等于整个账户已核验。

- Canonical: https://iotahome.site/zh/learn/ionet-private-api-connection
- Publisher: IOTA Watch
- Topics: io.net
- Published: 2026-10-24
- Updated: 2026-10-24

## 先看结论

连接是账户级的读取授权，设备 ID 是每台机器的选择。过期、被拒绝或断开后都要重新提交令牌。名额按已保存设备计，不按令牌计。

## 连接状态怎么处理

| 你看到的情况 | 含义 | 下一步 |
| --- | --- | --- |
| 需要连接 | 还没有可用的读取凭据 | 登录后提交令牌和一台设备 ID |
| 已过期或令牌被拒 | 保存已超过 7 天，或 io.net 不接受这把令牌 | 在 io.net 确认令牌后重新连接 |
| 已连接 | 这把令牌曾成功读到所填设备 | 用各台设备 ID 查看硬件和今日 IO |

## 直接回答

io.net 的读取不是公开地址查询。打开 [io.net 监控](https://iotahome.site/zh/projects/ionet)，登录，提交设备 UUID 和 Bearer 令牌。保存之前，必须用这把令牌成功读到你填写的那台设备。读不到就不会保存。

保存后的令牌加密放在服务器，绑定这个登录账户的 io.net 连接，最长 7 天。它只用于向 io.net 读取数据。断开连接会删除本站保存的凭据。io.net 上的授权要在原平台另行撤销。浏览器不保留令牌原文。

## 连接和设备各管什么

一条连接服务这一个账户下的 io.net 读取。再次保存会换掉旧令牌，不会变成两把并存的钥匙。设备 ID 仍然每台各填。官方调用是带 Bearer 头的设备详情：`GET /v1/io-explorer/devices/{device_id}/details`。

能读到一台设备，只说明保存那一刻这把令牌可以读这台设备。它不是对整个 io.net 账户的核验，也不会让令牌超过 7 天仍然有效。

## 保存设备怎么计数

- 免费每个项目 5 台已保存设备，Pro 为 50 台。数的是设备记录，不是令牌，也不是钱包地址。

- 控制台里看到多台 Worker，只要没有各自保存成设备记录，就不占名额。

- 同一条已保存设备上多次绑定 io.net，不增加名额。

- 每条记录上的今日 IO 只属于它的设备 ID，不会因为共用一把令牌就加总成双份。

## 行动分支

- 页面要求连接：先登录。未登录时提交不了这条私有读取。

- 令牌和 ID 都填了仍失败：在 io.net 核对令牌是否还能用、UUID 是否就是这把令牌能读的设备。不要改贴私钥。

- 提示过期：重新提交。7 天后旧凭据不再使用。

- 想停用：在监控断开连接，并在 io.net 撤销对应授权。

## 举例（示意）

账户保存了一把不展示的令牌，并填写示意设备 ID `11111111-1111-4111-8111-111111111111`。保存成功后，这台设备可以显示硬件名称和今日 IO。同一把连接再填另一个 UUID 时，不需要第二把令牌；若把第二台存成另一条设备记录，名额从 1 变为 2。第七天之后旧连接失效，两台都会停在需要重新连接，直到你提交新令牌。

本页不能开关 Worker。崩溃日志分析不收费，也不使用这把读取令牌去控制机器。Mac 端 Agent 只控制 Train at Home。接着看 [设备 ID 和私钥](https://iotahome.site/zh/learn/ionet-device-id-vs-worker-key) 与 [如何连接监控](https://iotahome.site/zh/learn/ionet-monitor-guide)。

## 常见问题

### 不登录可以只贴设备 ID 吗？

不能完成读取。io.net 需要账户上的读取凭据。先登录，再提交令牌。

### 7 天后旧令牌会怎样？

本站不再用它读取。页面会要求重新连接。是否仍能在 io.net 使用，以你在 io.net 的授权为准。

### 读通一台设备，是否表示账户已完全验证？

不是。它只说明保存时这把令牌能读这台设备。不能据此认为整个账户已核验，也不能延长 7 天期限。

## 资料来源与本站实现

- [io.net Device Details](https://io.net/docs/reference/io-explorer/get-device-details)
- [io.net](https://io.net/)