資料結構
Hexbon 不僅加密您的資料 - 還對其進行結構化。瞭解所需的 JSON 格式並驗證您的資料，以解鎖完整的互動式體驗。
章節
為什麼資料結構很重要
Hexbon 不僅僅是一個加密工具 - 它是一個結構化資料儲存系統。您的資料被組織成層次格式，支援拖放重排序、互動式卡片、可展開記錄和有組織的分區等強大功能。
結構與加密
如果您提供正確的加密金鑰，我們始終可以解密您的資料。但是，如果您的資料不遵循我們的結構指南，我們將以原始模式顯示它 - 您可以看到資料，但無法使用卡片、記錄、分區、拖放等互動式 UI 功能。
本文件解釋了 Hexbon 期望的精確 JSON 結構。遵循此結構可確保您的資料與我們的互動式儀表板功能完全相容。
結構概述
Hexbon 資料遵循嚴格的層次結構。理解這種層次結構是正確組織資料的關鍵。
資料層次結構
{ "cards": [...] }{
"title": "Personal",
"records": [...],
"updated_at": 1763938832
}{
"title": "Gmail",
"data": [...]
}{
"name": "Login",
"values": [...]
}{
"value": "secret123",
"type": "secret"
}| 屬性 | 必填 | 適用於 |
|---|---|---|
| cards | 是 | 根物件 |
| title | 是 | 卡片、記錄 |
| records | 是 | 卡片 |
| data | 是 | 記錄（分區陣列） |
| name | 是 | 分區 |
| values | 是 | 分區 |
| value | 是 | 值 |
| type | 是 | 值 (secret, note, totp, link, email) |
| id | 否 | 值（用於排序） |
| updated_at | 否 | 卡片（時間戳） |
卡片
卡片是儀表板中的頂級容器。每張卡片顯示為可點選的磁貼，可以展開以顯示其記錄。卡片可以透過拖放重新排序。
{
"title": "string", // Required: Card name displayed on tile
"records": [], // Required: Array of Record objects
"updated_at": 1763938832 // Optional: Unix timestamp of last update
}| 屬性 | 型別 | 必填 | 描述 |
|---|---|---|---|
| title | string | 是 | 顯示在卡片磁貼上的名稱 |
| records | array | 是 | Record 物件陣列（可為空） |
| updated_at | integer | 否 | 用於"最後更新"顯示的 Unix 時間戳 |
{
"title": "Work Credentials",
"records": [
// Record objects go here...
],
"updated_at": 1763938832
}記錄
記錄是卡片內的條目。當開啟卡片時，它們會出現在左側邊欄中，可以選擇檢視其分區。將記錄視為單獨的專案或條目（例如"Gmail 帳戶"、"工作 VPN"、"資料庫憑據"）。
{
"title": "string", // Required: Record name displayed in sidebar
"data": [] // Required: Array of Section objects
}| 屬性 | 型別 | 必填 | 描述 |
|---|---|---|---|
| title | string | 是 | 顯示在記錄列表中的名稱 |
| data | array | 是 | Section 物件陣列（可為空） |
注意：
data 屬性包含"分區"，而不是原始資料。這種命名是出於歷史原因。data 陣列中的每個專案都是一個 Section 物件。
{
"title": "Gmail Account",
"data": [
{
"name": "Login Details",
"values": [
// Value objects go here...
]
}
]
}分區
分區在記錄內對相關值進行分組。它們提供了一個組織層，有助於對不同型別的資訊進行分類（例如"登入詳情"、"恢復選項"、"API 金鑰"）。每個分區都有一個名稱幷包含多個值。
{
"name": "string", // Required: Section heading/label
"values": [] // Required: Array of Value objects
}| 屬性 | 型別 | 必填 | 描述 |
|---|---|---|---|
| name | string | 是 | 顯示在值上方的分區標題 |
| values | array | 是 | 包含您資料的 Value 物件陣列 |
{
"name": "Login Details",
"values": [
{
"value": "user@example.com",
"type": "note",
"id": "value_1763938238781_3jh5i3r20"
},
{
"value": "supersecretpassword123",
"type": "secret",
"id": "value_1763938251026_fvjeq1vg9"
}
]
}值
值是實際的資料條目 - 您儲存的密碼、筆記和 TOTP 程式碼。每個值都有一個型別，決定了它在 UI 中的顯示方式和互動方式。
{
"value": "string", // Required: The actual content
"type": "secret" | "note" | "totp" | "link" | "email" | "username", // Required
"id": "string" // Optional: Unique identifier for sorting
}| 屬性 | 型別 | 必填 | 描述 |
|---|---|---|---|
| value | string | 是 | 實際內容（密碼、筆記文字、TOTP 金鑰） |
| type | string | 是 | 以下之一："secret"、"note"、"totp"、"link"、"email" 或 "username" |
| id | string | 否 | 用於排序和引用的唯一識別符號 |
值型別
| 型別 | 顯示 | 使用場景 |
|---|---|---|
| "secret" | 預設隱藏（•••••），點選顯示 | 密碼、API 金鑰、敏感資料 |
| "note" | 始終可見的純文字 | 使用者名稱、電子郵件、URL、非敏感資訊 |
| "totp" | 生成實時 6 位驗證碼 | 雙因素認證金鑰（Base32 編碼） |
| "link" | 可點選的超連結 | URL、網站地址 |
| "email" | 帶 mailto 連結的電子郵件地址 | 電子郵件地址 |
| "username" | 帶使用者圖示的始終可見純文字 | 使用者名稱、帳戶識別符號 |
// Secret value (hidden by default)
{
"value": "MySecurePassword123!",
"type": "secret",
"id": "value_1763938251026_fvjeq1vg9"
}
// Note value (always visible)
{
"value": "user@example.com",
"type": "note",
"id": "value_1763938238781_3jh5i3r20"
}
// TOTP value (generates 2FA codes)
{
"value": "JBSWY3DPEHPK3PXP",
"type": "totp",
"id": "value_1763938267595_kaecs9y31"
}
// Username value (visible text with user icon)
{
"value": "john_doe_123",
"type": "username",
"id": "value_1763938289412_xm2kp7v91"
}完整示例
這是一個完整有效的資料結構，展示了包含多個卡片、記錄、分區和不同值型別的完整層次結構。
{
"cards": [
{
"title": "Personal Accounts",
"records": [
{
"title": "Gmail",
"data": [
{
"name": "Login Details",
"values": [
{
"value": "myemail@gmail.com",
"type": "note"
},
{
"value": "SuperSecretPassword123",
"type": "secret"
}
]
},
{
"name": "2FA",
"values": [
{
"value": "JBSWY3DPEHPK3PXP",
"type": "totp"
}
]
}
]
},
{
"title": "GitHub",
"data": [
{
"name": "Account",
"values": [
{
"value": "myusername",
"type": "note"
},
{
"value": "gh_token_abc123xyz",
"type": "secret"
}
]
}
]
}
],
"updated_at": 1763938832
},
{
"title": "Work",
"records": [
{
"title": "VPN Access",
"data": [
{
"name": "Credentials",
"values": [
{
"value": "vpn.company.com",
"type": "note"
},
{
"value": "john.doe",
"type": "note"
},
{
"value": "VpnP@ssw0rd!",
"type": "secret"
}
]
}
]
}
],
"updated_at": 1763856530
}
]
}原始資料模式
如果您的解密資料不遵循預期結構，Hexbon 仍會顯示它 - 但以原始模式顯示。這意味著您將看到資料作為純 JSON，而沒有結構化資料提供的互動功能。
| 功能 | 結構化模式 | 原始模式 |
|---|---|---|
| 互動式卡片磁貼 | ||
| 拖放重排序 | ||
| 密碼遮罩與顯示切換 | ||
| 實時 TOTP 程式碼生成 | ||
| 原位編輯和自動儲存 | ||
| 複製到剪貼簿按鈕 |
您的資料始終安全
原始模式僅影響顯示，不影響安全性。無論結構如何，您的資料始終使用 AES-256-GCM 加密。只是如果結構不匹配，您將無法獲得互動式 UI 功能。