Datová struktura
Hexbon vaše data nejen šifruje - on je také strukturuje. Přečtěte si o požadovaném formátu JSON a ověřte svá data, abyste odemkli plný interaktivní zážitek.
Kapitoly
Proč je datová struktura důležitá
Hexbon je víc než jen šifrovací nástroj; je to strukturovaný systém ukládání dat. Vaše data jsou organizována v hierarchickém formátu, který umožňuje výkonné funkce, jako je přeuspořádání pomocí drag-and-drop, interaktivní karty, rozbalitelné záznamy a organizované sekce.
Struktura vs. Šifrování
Vaše data můžeme vždy dešifrovat, pokud poskytnete správný šifrovací klíč. Pokud však vaše data nebudou splňovat naše pokyny pro strukturu, zobrazíme je v režimu raw - uvidíte data, ale bez interaktivních funkcí uživatelského rozhraní, jako jsou karty, záznamy, sekce, drag-and-drop atd.
Tato dokumentace vysvětluje přesnou strukturu JSON očekávanou systémem Hexbon. Dodržování této struktury zajišťuje, že vaše data budou plně kompatibilní s interaktivními funkcemi našeho panelu.
Přehled struktury
Data Hexbon se řídí přísnou hierarchií. Pochopení této hierarchie je klíčem ke správné organizaci vašich dat.
Datová hierarchie
{ "cards": [...] }{
"title": "Personal",
"records": [...],
"updated_at": 1763938832
}{
"title": "Gmail",
"data": [...]
}{
"name": "Login",
"values": [...]
}{
"value": "secret123",
"type": "secret"
}| Vlastnost | Povinné | Platí pro |
|---|---|---|
| cards | Ano | Kořenový objekt |
| title | Ano | Karta, Záznam |
| records | Ano | Karta |
| data | Ano | Záznam (pole sekcí) |
| name | Ano | Sekce |
| values | Ano | Sekce |
| value | Ano | Hodnota |
| type | Ano | Hodnota (secret, note, totp, link, email) |
| id | Ne | Hodnota (pro řazení) |
| updated_at | Ne | Karta (časové razítko) |
Karty
Karty jsou kontejnery nejvyšší úrovně ve vašem panelu. Každá karta se zobrazuje jako klikatelná dlaždice, kterou lze rozbalit a zobrazit její záznamy. Karty lze přeuspořádat pomocí drag-and-drop.
{
"title": "string", // Required: Card name displayed on tile
"records": [], // Required: Array of Record objects
"updated_at": 1763938832 // Optional: Unix timestamp of last update
}| Vlastnost | Typ | Povinné | Popis |
|---|---|---|---|
| title | string | Ano | Název zobrazený na dlaždici karty |
| records | array | Ano | Pole objektů Záznam (může být prázdné) |
| updated_at | integer | Ne | Unixový časový údaj pro zobrazení "poslední aktualizace" |
{
"title": "Work Credentials",
"records": [
// Record objects go here...
],
"updated_at": 1763938832
}Záznamy
Záznamy jsou položky uvnitř karty. Objevují se v levém postranním panelu po otevření karty a lze je vybrat pro zobrazení jejich sekcí. Představte si záznamy jako jednotlivé položky nebo vstupy (např. "Účet Gmail", "Firemní VPN", "Přihlašovací údaje k databázi").
{
"title": "string", // Required: Record name displayed in sidebar
"data": [] // Required: Array of Section objects
}| Vlastnost | Typ | Povinné | Popis |
|---|---|---|---|
| title | string | Ano | Název zobrazený v seznamu záznamů |
| data | array | Ano | Pole objektů Sekce (může být prázdné) |
Poznámka:
Vlastnost data obsahuje "sekce", nikoli nezpracovaná data. Toto pojmenování je z historických důvodů. Každá položka v poli data je objekt Sekce.
{
"title": "Gmail Account",
"data": [
{
"name": "Login Details",
"values": [
// Value objects go here...
]
}
]
}Sekce
Sekce seskupují související hodnoty v rámci záznamu. Poskytují organizační úroveň, která pomáhá kategorizovat různé typy informací (např. "Přihlašovací údaje", "Možnosti obnovení", "Klíče API"). Každá sekce má název a obsahuje více hodnot.
{
"name": "string", // Required: Section heading/label
"values": [] // Required: Array of Value objects
}| Vlastnost | Typ | Povinné | Popis |
|---|---|---|---|
| name | string | Ano | Záhlaví sekce zobrazené nad hodnotami |
| values | array | Ano | Pole objektů Hodnota obsahující vaše data |
{
"name": "Login Details",
"values": [
{
"value": "user@example.com",
"type": "note",
"id": "value_1763938238781_3jh5i3r20"
},
{
"value": "supersecretpassword123",
"type": "secret",
"id": "value_1763938251026_fvjeq1vg9"
}
]
}Hodnoty
Hodnoty jsou skutečné datové položky - hesla, poznámky a kódy TOTP, které ukládáte. Každá hodnota má typ, který určuje, jak se zobrazuje a jak s ní v uživatelském rozhraní pracujete.
{
"value": "string", // Required: The actual content
"type": "secret" | "note" | "totp" | "link" | "email" | "username", // Required
"id": "string" // Optional: Unique identifier for sorting
}| Vlastnost | Typ | Povinné | Popis |
|---|---|---|---|
| value | string | Ano | Skutečný obsah (heslo, text poznámky, tajemství TOTP) |
| type | string | Ano | Jeden z: "secret", "note", "totp", "link", "email" nebo "username" |
| id | string | Ne | Jedinečný identifikátor používaný pro řazení a odkazování |
Typy hodnot
| Typ | Zobrazení | Případ použití |
|---|---|---|
| "secret" | Ve výchozím nastavení skryté (•••••), kliknutím odhalíte | Hesla, klíče API, citlivá data |
| "note" | Prostý text vždy viditelný | Uživatelská jména, e-maily, adresy URL, necitlivé informace |
| "totp" | Generuje 6místné kódy v reálném čase | Tajemství 2FA (kódovaná v Base32) |
| "link" | Klikací hypertextový odkaz | URL, adresy webových stráek |
| "email" | E-mailová adresa s odkazem mailto | E-mailové adresy |
| "username" | Prostý text vždy viditelný s ikonou uživatele | Uživatelská jména, identifikátory účtů |
// 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"
}Kompletní příklad
Zde je kompletní, platná datová struktura ukazující celou hierarchii s více kartami, záznamy, sekcemi a různými typy hodnot.
{
"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
}
]
}Režim Raw
Pokud vaše dešifrovaná data nebudou splňovat očekávanou strukturu, Hexbon je přesto zobrazí, ale v režimu raw. To znamená, že uvidíte svá data jako prostý JSON bez interaktivních funkcí, které poskytují strukturovaná data.
| Funkce | Strukturovaný režim | Režim Raw |
|---|---|---|
| Interaktivní dlaždice karet | ||
| Přeuspořádání pomocí drag-and-drop | ||
| Maskování tajemství s přepínačem odhalení | ||
| Generování kódů TOTP v reálném čase | ||
| Úpravy na místě a automatické ukládání | ||
| Tlačítka pro kopírování do schránky |
Vaše data jsou vždy v bezpečí
Režim raw ovlivňuje pouze zobrazení, nikoli bezpečnost. Vaše data jsou vždy šifrována pomocí AES-256-GCM bez ohledu na strukturu. Pokud struktura neodpovídá, nebudete mít k dispozici interaktivní funkce uživatelského rozhraní.
Ověřte svou datovou strukturu
Použijte náš interaktivní validační nástroj ke kontrole datové struktury v reálném čase.
Vyzkoušet validační nástroj