Datastructuur
Hexbon versleutelt uw gegevens niet alleen - het structureert ze ook. Leer meer over het vereiste JSON-formaat en valideer uw gegevens om de volledige interactieve ervaring te ontgrendelen.
Hoofdstukken
Waarom datastructuur belangrijk is
Hexbon is meer dan een versleutelingstool; het is een gestructureerd gegevensopslagsysteem. Uw gegevens zijn georganiseerd in een hiërarchisch formaat dat krachtige functies mogelijk maakt, zoals drag-and-drop herschikking, interactieve kaarten, uitvouwbare records en georganiseerde secties.
Structuur vs Versleuteling
We kunnen uw gegevens altijd ontsleutelen als u de juiste versleutelingssleutel verstrekt. Als uw gegevens echter niet onze structuurrichtlijnen volgen, zullen we ze in raw-modus weergeven - u ziet de gegevens, maar zonder de interactieve UI-functies zoals kaarten, records, secties, drag-and-drop, enz.
Deze documentatie legt de exacte JSON-structuur uit die Hexbon verwacht. Het volgen van deze structuur zorgt ervoor dat uw gegevens volledig compatibel zijn met de interactieve functies van ons dashboard.
Structuuroverzicht
Hexbon-gegevens volgen een strikte hiërarchie. Het begrijpen van deze hiërarchie is de sleutel tot het correct organiseren van uw gegevens.
Gegevenshiërarchie
{ "cards": [...] }{
"title": "Personal",
"records": [...],
"updated_at": 1763938832
}{
"title": "Gmail",
"data": [...]
}{
"name": "Login",
"values": [...]
}{
"value": "secret123",
"type": "secret"
}| Eigenschap | Verplicht | Van toepassing op |
|---|---|---|
| cards | Ja | Root-object |
| title | Ja | Kaart, Record |
| records | Ja | Kaart |
| data | Ja | Record (array van secties) |
| name | Ja | Sectie |
| values | Ja | Sectie |
| value | Ja | Waarde |
| type | Ja | Waarde (secret, note, totp, link, email) |
| id | Nee | Waarde (voor sorteren) |
| updated_at | Nee | Kaart (timestamp) |
Kaarten
Kaarten zijn de containers op het hoogste niveau in uw dashboard. Elke kaart verschijnt als een klikbare tegel die kan worden uitgevouwen om de records te onthullen. Kaarten kunnen worden herschikt via 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
}| Eigenschap | Type | Verplicht | Beschrijving |
|---|---|---|---|
| title | string | Ja | De naam die op de kaarttegel wordt weergegeven |
| records | array | Ja | Array van Record-objecten (kan leeg zijn) |
| updated_at | integer | Nee | Unix-timestamp voor de "laatst bijgewerkt" weergave |
{
"title": "Work Credentials",
"records": [
// Record objects go here...
],
"updated_at": 1763938832
}Records
Records zijn items binnen een kaart. Ze verschijnen in de linkerzijbalk wanneer een kaart wordt geopend en kunnen worden geselecteerd om hun secties te bekijken. Denk aan records als individuele items of vermeldingen (bijv. "Gmail-account", "Bedrijfs-VPN", "Database-inloggegevens").
{
"title": "string", // Required: Record name displayed in sidebar
"data": [] // Required: Array of Section objects
}| Eigenschap | Type | Verplicht | Beschrijving |
|---|---|---|---|
| title | string | Ja | De naam die in de recordlijst wordt weergegeven |
| data | array | Ja | Array van Sectie-objecten (kan leeg zijn) |
Opmerking:
De eigenschap data bevat "secties", geen ruwe gegevens. Deze naamgeving is om historische redenen. Elk item in de data array is een Sectie-object.
{
"title": "Gmail Account",
"data": [
{
"name": "Login Details",
"values": [
// Value objects go here...
]
}
]
}Secties
Secties groeperen gerelateerde waarden binnen een record. Ze bieden een organisatieniveau dat helpt bij het categoriseren van verschillende soorten informatie (bijv. "Inloggegevens", "Herstelopties", "API-sleutels"). Elke sectie heeft een naam en bevat meerdere waarden.
{
"name": "string", // Required: Section heading/label
"values": [] // Required: Array of Value objects
}| Eigenschap | Type | Verplicht | Beschrijving |
|---|---|---|---|
| name | string | Ja | De sectiekop die boven de waarden wordt weergegeven |
| values | array | Ja | Array van Waarde-objecten die uw gegevens bevatten |
{
"name": "Login Details",
"values": [
{
"value": "user@example.com",
"type": "note",
"id": "value_1763938238781_3jh5i3r20"
},
{
"value": "supersecretpassword123",
"type": "secret",
"id": "value_1763938251026_fvjeq1vg9"
}
]
}Waarden
Waarden zijn de eigenlijke gegevensinvoer - de geheimen, notities en TOTP-codes die u opslaat. Elke waarde heeft een type dat bepaalt hoe deze wordt weergegeven en hoe u ermee communiceert in de UI.
{
"value": "string", // Required: The actual content
"type": "secret" | "note" | "totp" | "link" | "email" | "username", // Required
"id": "string" // Optional: Unique identifier for sorting
}| Eigenschap | Type | Verplicht | Beschrijving |
|---|---|---|---|
| value | string | Ja | De eigenlijke inhoud (wachtwoord, notitietekst, TOTP-geheim) |
| type | string | Ja | Eén van: "secret", "note", "totp", "link", "email" of "username" |
| id | string | Nee | Unieke identificatie gebruikt voor sorteren en referentie |
Waardetypen
| Type | Weergave | Use case |
|---|---|---|
| "secret" | Standaard verborgen (•••••), klik om te onthullen | Wachtwoorden, API-sleutels, gevoelige gegevens |
| "note" | Platte tekst altijd zichtbaar | Gebruikersnamen, e-mails, URL's, niet-gevoelige informatie |
| "totp" | Genereert realtime 6-cijferige codes | 2FA-geheimen (Base32 gecodeerd) |
| "link" | Klikbare hyperlink | URL's, website-adressen |
| "email" | E-mailadres met mailto-link | E-mailadressen |
| "username" | Platte tekst altijd zichtbaar met gebruikersicoon | Gebruikersnamen, account-ID's |
// 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"
}Volledig Voorbeeld
Hier is een volledige, geldige datastructuur die de hele hiërarchie laat zien met meerdere kaarten, records, secties en verschillende waardetypen.
{
"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 Modus
Als uw ontsleutelde gegevens de verwachte structuur niet volgen, zal Hexbon ze nog steeds weergeven, maar in raw-modus. Dit betekent dat u uw gegevens als eenvoudige JSON ziet zonder de interactieve functies die gestructureerde gegevens bieden.
| Functie | Gestructureerde Modus | Raw Modus |
|---|---|---|
| Interactieve kaarttegels | ||
| Drag-and-drop herschikking | ||
| Geheimmaskering met onthul-schakelaar | ||
| Realtime TOTP-codegeneratie | ||
| In-place bewerken en automatisch opslaan | ||
| Kopieer-naar-klembord knoppen |
Uw gegevens zijn altijd veilig
De raw-modus heeft alleen invloed op de weergave, niet op de beveiliging. Uw gegevens worden altijd versleuteld met AES-256-GCM-codering, ongeacht de structuur. U krijgt alleen niet de interactieve UI-functies als de structuur niet overeenkomt.
Valideer uw Datastructuur
Gebruik onze interactieve validatietool om uw datastructuur in realtime te controleren.
Probeer Validatietool