Struktura Danych
Hexbon nie tylko szyfruje Twoje dane - on je również strukturyzuje. Poznaj wymagany format JSON i zweryfikuj swoje dane, aby odblokować pełne interaktywne doświadczenie.
Rozdziały
Dlaczego struktura danych jest ważna
Hexbon to coś więcej niż narzędzie do szyfrowania; to strukturyzowany system przechowywania danych. Twoje dane są zorganizowane w formacie hierarchicznym, który umożliwia potężne funkcje, takie jak zmiana kolejności metodą przeciągnij i upuść, interaktywne karty, rozwijane rekordy i zorganizowane sekcje.
Struktura a Szyfrowanie
Zawsze możemy odszyfrować Twoje dane, jeśli podasz poprawny klucz szyfrowania. Jeśli jednak Twoje dane nie będą zgodne z naszymi wytycznymi dotyczącymi struktury, wyświetlimy je w trybie surowym (raw) - zobaczysz dane, ale bez interaktywnych funkcji interfejsu użytkownika, takich jak karty, rekordy, sekcje, przeciągnij i upuść itp.
Niniejsza dokumentacja wyjaśnia dokładną strukturę JSON oczekiwaną przez Hexbon. Przestrzeganie tej struktury gwarantuje, że Twoje dane będą w pełni kompatybilne z interaktywnymi funkcjami naszego panelu.
Przegląd Struktury
Dane Hexbon podlegają ścisłej hierarchii. Zrozumienie tej hierarchii jest kluczem do prawidłowego organizowania danych.
Hierarchia Danych
{ "cards": [...] }{
"title": "Personal",
"records": [...],
"updated_at": 1763938832
}{
"title": "Gmail",
"data": [...]
}{
"name": "Login",
"values": [...]
}{
"value": "secret123",
"type": "secret"
}| Właściwość | Wymagane | Dotyczy |
|---|---|---|
| cards | Tak | Obiekt główny |
| title | Tak | Karta, Rekord |
| records | Tak | Karta |
| data | Tak | Rekord (tablica sekcji) |
| name | Tak | Sekcja |
| values | Tak | Sekcja |
| value | Tak | Wartość |
| type | Tak | Wartość (secret, note, totp, link, email) |
| id | Nie | Wartość (do sortowania) |
| updated_at | Nie | Karta (znacznik czasu) |
Karty
Karty to kontenery najwyższego poziomu w Twoim panelu. Każda karta pojawia się jako klikalny kafel, który można rozwinąć, aby odkryć jej rekordy. Karty można przesuwać metodą przeciągnij i upuść.
{
"title": "string", // Required: Card name displayed on tile
"records": [], // Required: Array of Record objects
"updated_at": 1763938832 // Optional: Unix timestamp of last update
}| Właściwość | Typ | Wymagane | Opis |
|---|---|---|---|
| title | string | Tak | Nazwa wyświetlana na kaflu karty |
| records | array | Tak | Tablica obiektów Rekord (może być pusta) |
| updated_at | integer | Nie | Znacznik czasu Unix dla wyświetlania "ostatniej aktualizacji" |
{
"title": "Work Credentials",
"records": [
// Record objects go here...
],
"updated_at": 1763938832
}Rekordy
Rekordy to wpisy wewnątrz karty. Pojawiają się na lewym pasku bocznym po otwarciu karty i można je wybrać, aby wyświetlić ich sekcje. Myśl o rekordach jak o poszczególnych elementach lub wpisach (np. "Konto Gmail", "Firmowy VPN", "Dane logowania do bazy danych").
{
"title": "string", // Required: Record name displayed in sidebar
"data": [] // Required: Array of Section objects
}| Właściwość | Typ | Wymagane | Opis |
|---|---|---|---|
| title | string | Tak | Nazwa wyświetlana na liście rekordów |
| data | array | Tak | Tablica obiektów Sekcja (może być pusta) |
Uwaga:
Właściwość data zawiera "sekcje", a nie surowe dane. Ta nazwa wynika z przyczyn historycznych. Każdy element w tablicy data jest obiektem Sekcji.
{
"title": "Gmail Account",
"data": [
{
"name": "Login Details",
"values": [
// Value objects go here...
]
}
]
}Sekcje
Sekcje grupują powiązane wartości wewnątrz rekordu. Zapewniają poziom organizacyjny, który pomaga kategoryzować różne rodzaje informacji (np. "Dane logowania", "Opcje odzyskiwania", "Klucze API"). Każda sekcja ma nazwę i zawiera wiele wartości.
{
"name": "string", // Required: Section heading/label
"values": [] // Required: Array of Value objects
}| Właściwość | Typ | Wymagane | Opis |
|---|---|---|---|
| name | string | Tak | Nagłówek sekcji wyświetlany nad wartościami |
| values | array | Tak | Tablica obiektów Wartość zawierająca Twoje dane |
{
"name": "Login Details",
"values": [
{
"value": "user@example.com",
"type": "note",
"id": "value_1763938238781_3jh5i3r20"
},
{
"value": "supersecretpassword123",
"type": "secret",
"id": "value_1763938251026_fvjeq1vg9"
}
]
}Wartości
Wartości to rzeczywiste wpisy danych - hasła, notatki i kody TOTP, które przechowujesz. Każda wartość ma typ, który określa, jak jest wyświetlana i jak wchodzisz z nią w interakcję w interfejsie.
{
"value": "string", // Required: The actual content
"type": "secret" | "note" | "totp" | "link" | "email" | "username", // Required
"id": "string" // Optional: Unique identifier for sorting
}| Właściwość | Typ | Wymagane | Opis |
|---|---|---|---|
| value | string | Tak | Rzeczywista treść (hasło, treść notatki, sekret TOTP) |
| type | string | Tak | Jeden z: "secret", "note", "totp", "link", "email" lub "username" |
| id | string | Nie | Unikalny identyfikator używany do sortowania i odniesienia |
Typy Wartości
| Typ | Wyświetlanie | Zastosowanie |
|---|---|---|
| "secret" | Domyślnie ukryte (•••••), kliknij, aby odkryć | Hasła, klucze API, dane wrażliwe |
| "note" | Zwykły tekst zawsze widoczny | Nazwy użytkownika, e-maile, adresy URL, informacje niewrażliwe |
| "totp" | Generuje 6-cyfrowe kody w czasie rzeczywistym | Sekrety 2FA (zakodowane w Base32) |
| "link" | Klikalny hiperłącze | Adresy URL, adresy stron internetowych |
| "email" | Adres e-mail z linkiem mailto | Adresy e-mail |
| "username" | Zwykły tekst zawsze widoczny z ikoną użytkownika | Nazwy użytkownika, identyfikatory kont |
// 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"
}Pełny Przykład
Oto kompletna, poprawna struktura danych pokazująca całą hierarchię z wieloma kartami, rekordami, sekcjami i różnymi typami wartości.
{
"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
}
]
}Tryb Surowy (Raw)
Jeśli Twoje odszyfrowane dane nie będą zgodne z oczekiwaną strukturą, Hexbon nadal je wyświetli, ale w trybie surowym. Oznacza to, że zobaczysz swoje dane jako zwykły JSON bez interaktywnych funkcji zapewnianych przez dane strukturalne.
| Funkcja | Tryb Strukturalny | Tryb Surowy |
|---|---|---|
| Interaktywne kafle kart | ||
| Zmiana kolejności przeciągnij i upuść | ||
| Maskowanie haseł z przełącznikiem odkrywania | ||
| Generowanie kodów TOTP w czasie rzeczywistym | ||
| Edycja na miejscu i automatyczne zapisywanie | ||
| Przyciski kopiowania do schowka |
Twoje dane są zawsze bezpieczne
Tryb surowy wpływa tylko na wyświetlanie, a nie na bezpieczeństwo. Twoje dane są zawsze szyfrowane szyfrem AES-256-GCM niezależnie od struktury. Po prostu nie otrzymasz interaktywnych funkcji interfejsu użytkownika, jeśli struktura nie będzie pasować.
Zweryfikuj Swoją Strukturę Danych
Skorzystaj z naszego interaktywnego narzędzia do walidacji, aby sprawdzić swoją strukturę danych w czasie rzeczywistym.
Wypróbuj Narzędzie Walidacji