Structura Datelor
Hexbon nu doar îți criptează datele - le și structurează. Învață formatul JSON necesar și validează-ți datele pentru a debloca experiența interactivă completă.
Capitole
De ce contează structura datelor
Hexbon este mai mult decât un instrument de criptare - este un sistem de stocare a datelor structurate. Datele tale sunt organizate într-un format ierarhic care permite funcții puternice precum reordonarea prin drag-and-drop, carduri interactive, înregistrări expandabile și secțiuni organizate.
Structură vs. Criptare
Putem decripta întotdeauna datele tale dacă furnizezi cheia de criptare corectă. Totuși, dacă datele tale nu respectă liniile noastre directoare de structură, le vom afișa în modul brut (raw) - vei vedea datele, dar fără funcțiile UI interactive precum carduri, înregistrări, secțiuni, drag-and-drop etc.
Această documentație explică structura JSON exactă așteptată de Hexbon. Respectarea acestei structuri asigură compatibilitatea deplină a datelor tale cu funcțiile interactive ale panoului nostru de control.
Prezentare Generală a Structurii
Datele Hexbon urmează o structură ierarhică strictă. Înțelegerea acestei ierarhii este cheia pentru organizarea corectă a datelor tale.
Ierarhia Datelor
{ "cards": [...] }{
"title": "Personal",
"records": [...],
"updated_at": 1763938832
}{
"title": "Gmail",
"data": [...]
}{
"name": "Login",
"values": [...]
}{
"value": "secret123",
"type": "secret"
}| Proprietate | Obligatoriu | Se aplică la |
|---|---|---|
| cards | Da | Obiect rădăcină |
| title | Da | Card, Înregistrare |
| records | Da | Card |
| data | Da | Înregistrare (tablou de secțiuni) |
| name | Da | Secțiune |
| values | Da | Secțiune |
| value | Da | Valoare |
| type | Da | Valoare (secret, note, totp, link, email, username) |
| id | Nu | Valoare (pentru sortare) |
| updated_at | Nu | Card (timestamp) |
Carduri
Cardurile sunt containerele de nivel superior din panoul tău de control. Fiecare card apare ca o casetă pe care se poate face clic și care poate fi extinsă pentru a dezvălui înregistrările sale. Cardurile pot fi reordonate prin 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
}| Proprietate | Tip | Obligatoriu | Descriere |
|---|---|---|---|
| title | string | Da | Numele afișat pe caseta cardului |
| records | array | Da | Tablou de obiecte Înregistrare (poate fi gol) |
| updated_at | integer | Nu | Timestamp Unix pentru afișarea "ultimei actualizări" |
{
"title": "Work Credentials",
"records": [
// Record objects go here...
],
"updated_at": 1763938832
}Înregistrări
Înregistrările sunt intrări în cadrul unui card. Ele apar în bara laterală din stânga când un card este deschis și pot fi selectate pentru a vizualiza secțiunile lor. Gândește-te la înregistrări ca la elemente sau intrări individuale (ex: "Cont Gmail", "VPN Serviciu", "Credențiale Bază de Date").
{
"title": "string", // Required: Record name displayed in sidebar
"data": [] // Required: Array of Section objects
}| Proprietate | Tip | Obligatoriu | Descriere |
|---|---|---|---|
| title | string | Da | Numele afișat în lista de înregistrări |
| data | array | Da | Tablou de obiecte Secțiune (poate fi gol) |
Notă:
Proprietatea data conține "secțiuni", nu date brute. Această denumire este din motive istorice. Fiecare element din tabloul data este un obiect Secțiune.
{
"title": "Gmail Account",
"data": [
{
"name": "Login Details",
"values": [
// Value objects go here...
]
}
]
}Secțiuni
Secțiunile grupează valorile corelate în cadrul unei înregistrări. Ele oferă un strat organizațional care ajută la categorisirea diferitelor tipuri de informații (ex: "Detalii Autentificare", "Opțiuni Recuperare", "Chei API"). Fiecare secțiune are un nume și conține mai multe valori.
{
"name": "string", // Required: Section heading/label
"values": [] // Required: Array of Value objects
}| Proprietate | Tip | Obligatoriu | Descriere |
|---|---|---|---|
| name | string | Da | Titlul secțiunii afișat deasupra valorilor |
| values | array | Da | Tablou de obiecte Valoare care conțin datele tale |
{
"name": "Login Details",
"values": [
{
"value": "user@example.com",
"type": "note",
"id": "value_1763938238781_3jh5i3r20"
},
{
"value": "supersecretpassword123",
"type": "secret",
"id": "value_1763938251026_fvjeq1vg9"
}
]
}Valori
Valorile sunt intrările de date propriu-zise - secretele, notele și codurile TOTP pe care le stochezi. Fiecare valoare are un tip care determină modul în care este afișată și modul în care se interacționează cu ea în interfața de utilizator.
{
"value": "string", // Required: The actual content
"type": "secret" | "note" | "totp" | "link" | "email" | "username", // Required
"id": "string" // Optional: Unique identifier for sorting
}| Proprietate | Tip | Obligatoriu | Descriere |
|---|---|---|---|
| value | string | Da | Conținutul propriu-zis (parolă, text notă, secret TOTP) |
| type | string | Da | Unul dintre: "secret", "note", "totp", "link", "email" sau "username" |
| id | string | Nu | Identificator unic utilizat pentru sortare și referențiere |
Tipuri de Valori
| Tip | Afișare | Caz de utilizare |
|---|---|---|
| "secret" | Ascuns implicit (•••••), clic pentru a dezvălui | Parole, chei API, date sensibile |
| "note" | Text simplu vizibil întotdeauna | Nume de utilizator, email-uri, URL-uri, informații nesensibile |
| "totp" | Generează coduri live din 6 cifre | Secrete 2FA (codificate Base32) |
| "link" | Hiperlink pe care se poate face clic | URL-uri, adrese de site-uri web |
| "email" | Adresă de email cu link mailto | Adrese de email |
| "username" | Text simplu vizibil întotdeauna cu pictogramă utilizator | Nume de utilizator, identificatori de cont |
// 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"
}Exemplu Complet
Iată o structură de date completă și validă, care arată ierarhia completă cu mai multe carduri, înregistrări, secțiuni și diferite tipuri de valori.
{
"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
}
]
}Modul Date Brute (Raw)
Dacă datele tale decriptate nu respectă structura așteptată, Hexbon le va afișa totuși - dar în modul brut (raw). Aceasta înseamnă că vei vedea datele tale ca JSON simplu, fără funcțiile interactive pe care le oferă datele structurate.
| Funcție | Mod Structurat | Mod Brut (Raw) |
|---|---|---|
| Casete de card interactive | ||
| Reordonare prin drag-and-drop | ||
| Mascarea secretelor cu comutator de dezvăluire | ||
| Generare live de coduri TOTP | ||
| Editare pe loc și salvare automată | ||
| Butoane de copiere în clipboard |
Datele tale sunt întotdeauna în siguranță
Modul brut afectează doar afișarea, nu securitatea. Datele tale sunt întotdeauna criptate cu criptare AES-256-GCM, indiferent de structură. Pur și simplu nu vei beneficia de funcțiile UI interactive dacă structura nu se potrivește.
Validează Structura Datelor Tale
Folosește instrumentul nostru interactiv de validare pentru a verifica structura datelor tale în timp real.
Încearcă Instrumentul de Validare