# io.net 讀取憑證如何保存：7 天、僅伺服器、中斷即刪

登入後提交 Bearer 權杖。保存前必須能讀到你填寫的那台設備。憑證加密存放最多 7 天，一個帳戶一條 io.net 連接。成功讀取一台設備不等於整個帳戶已核驗。

- Canonical: https://iotahome.site/zh-TW/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-TW/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-TW/learn/ionet-device-id-vs-worker-key) 與 [如何連接監控](https://iotahome.site/zh-TW/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/)