- Home
- Istruktura ng Data
Istraktura ng Data
Hindi lamang ine-encrypt ng Hexbon ang iyong data - isinasagawa rin nito ang pag-istraktura nito. Alamin ang kinakailangang format ng JSON at i-validate ang iyong data upang ma-unlock ang buong interactive na karanasan.
Mga Kabanata
Bakit Mahalaga ang Istraktura ng Data
Ang Hexbon ay higit pa sa isang tool sa pag-encrypt; ito ay isang structured data storage system. Ang iyong data ay nakaayos sa isang hierarchical na format na nagbibigay-daan sa mga makapangyarihang feature tulad ng drag-and-drop reordering, interactive na mga card, mapapalawak na mga record, at organisadong mga seksyon.
Istraktura vs Pag-encrypt
Maaari naming palaging i-decrypt ang iyong data kung ibibigay mo ang tamang encryption key. Gayunpaman, kung ang iyong data ay hindi sumusunod sa aming mga alituntunin sa istraktura, ipapakita namin ito sa raw mode - makikita mo ang data, ngunit wala ang mga interactive na feature ng UI tulad ng mga card, record, seksyon, drag-and-drop, atbp.
Binabalangkas ng dokumentasyong ito ang eksaktong istraktura ng JSON na inaasahan ng Hexbon. Ang pagsunod sa istrukturang ito ay nagsisiguro na ang iyong data ay ganap na tugma sa mga interactive na feature ng aming dashboard.
Pangkalahatang-ideya ng Istraktura
Ang data ng Hexbon ay sumusunod sa isang mahigpit na hierarchy. Ang pag-unawa sa hierarchy na ito ay susi sa pag-aayos ng iyong data nang tama.
Hierarchy ng Data
{ "cards": [...] }
{
"title": "Personal",
"records": [...],
"updated_at": 1763938832
}
{
"title": "Gmail",
"data": [...]
}
{
"name": "Login",
"values": [...]
}
{
"value": "secret123",
"type": "secret"
}
| Property | Kinakailangan | Nalalapat Sa |
|---|---|---|
| cards | Oo | Root Object |
| title | Oo | Card, Record |
| records | Oo | Card |
| data | Oo | Record (array ng mga seksyon) |
| name | Oo | Seksyon |
| values | Oo | Seksyon |
| value | Oo | Value |
| type | Oo | Value (secret, note, totp, link, email) |
| id | Hindi | Value (para sa pag-uuri) |
| updated_at | Hindi | Card (timestamp) |
Mga Card
Ang mga card ay ang mga top-level na container sa iyong dashboard. Lumilitaw ang bawat card bilang isang naki-click na kahon na maaaring palawakin upang ipakita ang mga record nito. Maaaring muling ayusin ang mga card sa pamamagitan ng 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
}
| Property | Uri | Kinakailangan | Paglalarawan |
|---|---|---|---|
| title | string | Oo | Ang pangalang ipinapakita sa kahon ng card |
| records | array | Oo | Array ng mga record object (maaaring walang laman) |
| updated_at | integer | Hindi | Unix timestamp para ipakita ang "huling na-update" |
{
"title": "Work Credentials",
"records": [
// Record objects go here...
],
"updated_at": 1763938832
}
Mga Record
Ang mga record ay mga entry sa loob ng isang card. Lumilitaw ang mga ito sa kaliwang sidebar kapag binuksan ang isang card at maaaring piliin upang tingnan ang mga seksyon nito. Isipin ang mga record bilang mga indibidwal na item o entry (hal. "Gmail Account", "Company VPN", "Database Credentials").
{
"title": "string", // Required: Record name displayed in sidebar
"data": [] // Required: Array of Section objects
}
| Property | Uri | Kinakailangan | Paglalarawan |
|---|---|---|---|
| title | string | Oo | Ang pangalang ipinapakita sa listahan ng record |
| data | array | Oo | Array ng mga seksyon object (maaaring walang laman) |
Tandaan:
Ang property na data ay naglalaman ng "mga seksyon", hindi raw data. Ang pagpapangalan na ito ay para sa mga makasaysayang dahilan. Ang bawat item sa data array ay isang seksyon object.
{
"title": "Gmail Account",
"data": [
{
"name": "Login Details",
"values": [
// Value objects go here...
]
}
]
}
Mga Seksyon
Pinapangkat ng mga seksyon ang mga kaugnay na value sa loob ng isang record. Nagbibigay ang mga ito ng antas ng organisasyon na tumutulong sa pag-uuri ng iba't ibang uri ng impormasyon (hal. "Mga Detalye ng Login", "Mga Opsyon sa Pagbawi", "Mga API Key"). Ang bawat seksyon ay may pangalan at naglalaman ng maraming value.
{
"name": "string", // Required: Section heading/label
"values": [] // Required: Array of Value objects
}
| Property | Uri | Kinakailangan | Paglalarawan |
|---|---|---|---|
| name | string | Oo | Ang pamagat ng seksyon na ipinapakita sa itaas ng mga value |
| values | array | Oo | Array ng mga value object na naglalaman ng iyong data |
{
"name": "Login Details",
"values": [
{
"value": "user@example.com",
"type": "note",
"id": "value_1763938238781_3jh5i3r20"
},
{
"value": "supersecretpassword123",
"type": "secret",
"id": "value_1763938251026_fvjeq1vg9"
}
]
}
Mga Value
Ang mga value ay ang mga aktwal na entry ng data - mga password, tala, at TOTP code na iyong iniimbak. Ang bawat value ay may uri na tumutukoy kung paano ito ipinapakita at kung paano ito nakikipag-ugnayan sa UI.
{
"value": "string", // Required: The actual content
"type": "secret" | "note" | "totp" | "link" | "email" | "username", // Required
"id": "string" // Optional: Unique identifier for sorting
}
| Property | Uri | Kinakailangan | Paglalarawan |
|---|---|---|---|
| value | string | Oo | Ang aktwal na nilalaman (password, teksto ng tala, TOTP secret) |
| type | string | Oo | Isa sa: "secret", "note", "totp", "link", "email", o "username" |
| id | string | Hindi | Isang natatanging ID na ginagamit para sa pag-uuri at sanggunian |
Mga Uri ng Value
| Uri | Display | Gamit |
|---|---|---|
| "secret" | Nakatago bilang default (•••••), i-click upang ipakita | Mga password, API key, sensitibong data |
| "note" | Plain text na laging nakikita | Mga username, email, URL, impormasyong hindi sensitibo |
| "totp" | Bumubuo ng mga 6-digit na code sa real-time | Mga 2FA secret (Base32 encoded) |
| "link" | Naki-click na hyperlink | Mga URL, mga address ng website |
| "email" | Email address na may mailto link | Mga email address |
| "username" | Plain text na laging nakikita na may icon ng user | Mga username, mga account ID |
// 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"
}
Kumpletong Halimbawa
Narito ang isang kumpleto at wastong istraktura ng data na nagpapakita ng buong hierarchy na may maraming card, record, seksyon, at iba't ibang uri ng value.
{
"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
}
]
}
Raw Mode
Kung ang iyong na-decrypt na data ay hindi sumusunod sa inaasahang istraktura, ipapakita pa rin ito ng Hexbon, ngunit sa raw mode. Nangangahulugan ito na makikita mo ang iyong data bilang simpleng JSON nang wala ang mga interactive na feature na ibinibigay ng structured data.
| Feature | Structured na Mode | Raw na Mode |
|---|---|---|
| Interactive na mga kahon ng card | ||
| Pag-aayos sa pamamagitan ng drag-and-drop | ||
| Secret masking na may reveal toggle | ||
| Real-time na pagbuo ng TOTP code | ||
| In-place editing at auto-save | ||
| Mga button para sa pagkopya sa clipboard |
Laging Ligtas ang Iyong Data
Ang raw mode ay nakakaapekto lamang sa presentasyon, hindi sa seguridad. Ang iyong data ay palaging AES-256-GCM encrypted anuman ang istraktura. Hindi mo lang makukuha ang mga interactive na feature ng UI kung hindi tumutugma ang istraktura.
I-validate ang Iyong Istraktura ng Data
Gamitin ang aming interactive na validation tool upang suriin ang iyong istraktura ng data sa real-time.
Subukan ang Validation Tool