Struktur Data
Hexbon bukan sahaja menyulitkan data anda - ia juga menyusunnya. Ketahui format JSON yang diperlukan dan sahkan data anda untuk membuka kunci pengalaman interaktif sepenuhnya.
Bab
Mengapa Struktur Data Penting
Hexbon adalah lebih daripada sekadar alat penyulitan; ia adalah sistem penyimpanan data berstruktur. Data anda disusun dalam format hierarki yang membolehkan ciri berkuasa seperti penyusunan semula seret-dan-lepas, kad interaktif, rekod yang boleh dikembangkan dan bahagian yang teratur.
Struktur vs Penyulitan
Kami sentiasa boleh menyahsulit data anda jika anda memberikan kunci penyulitan yang betul. Walau bagaimanapun, jika data anda tidak mengikut garis panduan struktur kami, kami akan memaparkannya dalam mod mentah (raw mode) - anda akan melihat data tersebut, tetapi tanpa ciri UI interaktif seperti kad, rekod, bahagian, seret-dan-lepas, dsb.
Dokumentasi ini menggariskan struktur JSON tepat yang diharapkan oleh Hexbon. Mengikuti struktur ini memastikan data anda serasi sepenuhnya dengan ciri interaktif papan pemuka kami.
Gambaran Keseluruhan Struktur
Data Hexbon mengikut hierarki yang ketat. Memahami hierarki ini adalah kunci untuk menyusun data anda dengan betul.
Hierarki Data
{ "cards": [...] }{
"title": "Personal",
"records": [...],
"updated_at": 1763938832
}{
"title": "Gmail",
"data": [...]
}{
"name": "Login",
"values": [...]
}{
"value": "secret123",
"type": "secret"
}| Sifat | Diperlukan | Digunakan Untuk |
|---|---|---|
| cards | Ya | Objek Akar |
| title | Ya | Kad, Rekod |
| records | Ya | Kad |
| data | Ya | Rekod (tatasusunan bahagian) |
| name | Ya | Bahagian |
| values | Ya | Bahagian |
| value | Ya | Nilai |
| type | Ya | Nilai (secret, note, totp, link, email) |
| id | Tidak | Nilai (untuk pengisihan) |
| updated_at | Tidak | Kad (cap masa) |
Kad
Kad ialah bekas peringkat teratas dalam papan pemuka anda. Setiap kad muncul sebagai kotak yang boleh diklik yang boleh dikembangkan untuk mendedahkan rekodnya. Kad boleh disusun semula melalui seret-dan-lepas.
{
"title": "string", // Required: Card name displayed on tile
"records": [], // Required: Array of Record objects
"updated_at": 1763938832 // Optional: Unix timestamp of last update
}| Sifat | Jenis | Diperlukan | Penerangan |
|---|---|---|---|
| title | string | Ya | Nama yang dipaparkan pada kotak kad |
| records | array | Ya | Tatasusunan objek rekod (boleh kosong) |
| updated_at | integer | Tidak | Cap masa Unix untuk menunjukkan "terakhir dikemas kini" |
{
"title": "Work Credentials",
"records": [
// Record objects go here...
],
"updated_at": 1763938832
}Rekod
Rekod ialah entri dalam kad. Ia muncul di bar sisi kiri apabila kad dibuka dan boleh dipilih untuk melihat bahagiannya. Anggap rekod sebagai item atau entri individu (cth. "Akaun Gmail", "VPN Syarikat", "Kredensial Pangkalan Data").
{
"title": "string", // Required: Record name displayed in sidebar
"data": [] // Required: Array of Section objects
}| Sifat | Jenis | Diperlukan | Penerangan |
|---|---|---|---|
| title | string | Ya | Nama yang dipaparkan dalam senarai rekod |
| data | array | Ya | Tatasusunan objek bahagian (boleh kosong) |
Nota:
Sifat data mengandungi "bahagian", bukan data mentah. Penamaan ini adalah atas sebab sejarah. Setiap item dalam tatasusunan data ialah objek bahagian.
{
"title": "Gmail Account",
"data": [
{
"name": "Login Details",
"values": [
// Value objects go here...
]
}
]
}Bahagian
Bahagian mengumpulkan nilai berkaitan dalam rekod. Ia menyediakan tahap organisasi yang membantu mengkategorikan pelbagai jenis maklumat (cth. "Butiran Log Masuk", "Pilihan Pemulihan", "Kunci API"). Setiap bahagian mempunyai nama dan mengandungi berbilang nilai.
{
"name": "string", // Required: Section heading/label
"values": [] // Required: Array of Value objects
}| Sifat | Jenis | Diperlukan | Penerangan |
|---|---|---|---|
| name | string | Ya | Tajuk bahagian dipaparkan di atas nilai |
| values | array | Ya | Tatasusunan objek nilai yang mengandungi data anda |
{
"name": "Login Details",
"values": [
{
"value": "user@example.com",
"type": "note",
"id": "value_1763938238781_3jh5i3r20"
},
{
"value": "supersecretpassword123",
"type": "secret",
"id": "value_1763938251026_fvjeq1vg9"
}
]
}Nilai
Nilai ialah entri data sebenar - kata laluan, nota dan kod TOTP yang anda simpan. Setiap nilai mempunyai jenis yang menentukan cara ia dipaparkan dan cara ia berinteraksi dalam UI.
{
"value": "string", // Required: The actual content
"type": "secret" | "note" | "totp" | "link" | "email" | "username", // Required
"id": "string" // Optional: Unique identifier for sorting
}| Sifat | Jenis | Diperlukan | Penerangan |
|---|---|---|---|
| value | string | Ya | Kandungan sebenar (kata laluan, teks nota, rahsia TOTP) |
| type | string | Ya | Salah satu daripada: "secret", "note", "totp", "link", "email", atau "username" |
| id | string | Tidak | ID unik yang digunakan untuk pengisihan dan rujukan |
Jenis Nilai
| Jenis | Paparan | Kes Penggunaan |
|---|---|---|
| "secret" | Tersembunyi secara lalai (•••••), klik untuk mendedahkan | Kata laluan, kunci API, data sensitif |
| "note" | Teks biasa sentiasa kelihatan | Nama pengguna, e-mel, URL, maklumat tidak sensitif |
| "totp" | Menjana kod 6 digit dalam masa nyata | Rahsia 2FA (Base32 encoded) |
| "link" | Hiperpautan yang boleh diklik | URL, alamat laman web |
| "email" | Alamat e-mel dengan pautan mailto | Alamat e-mel |
| "username" | Teks biasa sentiasa kelihatan dengan ikon pengguna | Nama pengguna, ID akaun |
// 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"
}Contoh Lengkap
Berikut ialah struktur data yang lengkap dan sah yang menunjukkan keseluruhan hierarki dengan berbilang kad, rekod, bahagian dan pelbagai jenis nilai.
{
"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
}
]
}Mod Mentah (Raw Mode)
Jika data anda yang dinyahsulit tidak mengikut struktur yang dijangkakan, Hexbon akan memaparkannya juga, tetapi dalam mod mentah. Ini bermakna anda akan melihat data anda sebagai JSON ringkas tanpa ciri interaktif yang disediakan oleh data berstruktur.
| Ciri | Mod Berstruktur | Mod Mentah |
|---|---|---|
| Kotak kad interaktif | ||
| Penyusunan semula seret-dan-lepas | ||
| Penyamaran rahsia dengan togol dedah | ||
| Penjanaan kod TOTP masa nyata | ||
| Penyuntingan di tempat dan simpan automatik | ||
| Butang salin ke papan keratan |
Data Anda Sentiasa Selamat
Mod mentah hanya menjejaskan persembahan, bukan keselamatan. Data anda sentiasa disulitkan AES-256-GCM tanpa mengira struktur. Anda cuma tidak akan mendapat ciri UI interaktif jika struktur tidak sepadan.
Sahkan Struktur Data Anda
Gunakan alat pengesahan interaktif kami untuk menyemak struktur data anda dalam masa nyata.
Cuba Alat Pengesahan