Estrutura de Dados
O Hexbon não se limita a encriptar os seus dados - ele estrutura-os. Conheça o formato JSON necessário e valide os seus dados para desbloquear a experiência interativa completa.
Capítulos
Por que a estrutura de dados é importante
O Hexbon é mais do que uma ferramenta de encriptação; é um sistema de armazenamento de dados estruturado. Os seus dados são organizados num formato hierárquico que permite funcionalidades poderosas como reordenação por arrastar e largar, cartões interativos, registos expansíveis e secções organizadas.
Estrutura vs Encriptação
Podemos sempre desencriptar os seus dados se fornecer a chave de encriptação correta. No entanto, se os seus dados não seguirem as nossas diretrizes de estrutura, iremos exibi-los em modo bruto (raw) - verá os dados, mas sem as funcionalidades interativas da interface, como cartões, registos, secções, arrastar e largar, etc.
Esta documentação explica a estrutura JSON exata esperada pelo Hexbon. Seguir esta estrutura garante que os seus dados sejam totalmente compatíveis com as funcionalidades interativas do nosso painel.
Visão Geral da Estrutura
Os dados do Hexbon seguem uma hierarquia rigorosa. Compreender esta hierarquia é fundamental para organizar os seus dados corretamente.
Hierarquia de Dados
{ "cards": [...] }{
"title": "Personal",
"records": [...],
"updated_at": 1763938832
}{
"title": "Gmail",
"data": [...]
}{
"name": "Login",
"values": [...]
}{
"value": "secret123",
"type": "secret"
}| Propriedade | Obrigatório | Aplica-se a |
|---|---|---|
| cards | Sim | Objeto raiz |
| title | Sim | Cartão, Registo |
| records | Sim | Cartão |
| data | Sim | Registo (array de secções) |
| name | Sim | Secção |
| values | Sim | Secção |
| value | Sim | Valor |
| type | Sim | Valor (secret, note, totp, link, email) |
| id | Não | Valor (para ordenação) |
| updated_at | Não | Cartão (timestamp) |
Cartões
Os cartões são os contentores de nível superior no seu painel. Cada cartão aparece como um bloco clicável que pode ser expandido para revelar os seus registos. Os cartões podem ser reordenados por arrastar e largar.
{
"title": "string", // Required: Card name displayed on tile
"records": [], // Required: Array of Record objects
"updated_at": 1763938832 // Optional: Unix timestamp of last update
}| Propriedade | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| title | string | Sim | O nome exibido no bloco do cartão |
| records | array | Sim | Array de objetos de Registo (pode estar vazio) |
| updated_at | integer | Não | Timestamp Unix para a exibição de "última atualização" |
{
"title": "Work Credentials",
"records": [
// Record objects go here...
],
"updated_at": 1763938832
}Registos
Os registos são entradas dentro de um cartão. Aparecem na barra lateral esquerda quando um cartão é aberto e podem ser selecionados para visualizar as suas secções. Pense nos registos como itens individuais (ex: "Conta Gmail", "VPN da Empresa", "Credenciais da Base de Dados").
{
"title": "string", // Required: Record name displayed in sidebar
"data": [] // Required: Array of Section objects
}| Propriedade | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| title | string | Sim | O nome exibido na lista de registos |
| data | array | Sim | Array de objetos de Secção (pode estar vazio) |
Nota:
A propriedade data contém "secções", não dados brutos. Esta nomenclatura deve-se a razões históricas. Cada item no array data é um objeto de Secção.
{
"title": "Gmail Account",
"data": [
{
"name": "Login Details",
"values": [
// Value objects go here...
]
}
]
}Secções
As secções agrupam valores relacionados dentro de um registo. Elas fornecem um nível organizacional que ajuda a categorizar diferentes tipos de informação (ex: "Detalhes de Login", "Opções de Recuperação", "Chaves de API"). Cada secção tem um nome e contém múltiplos valores.
{
"name": "string", // Required: Section heading/label
"values": [] // Required: Array of Value objects
}| Propriedade | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| name | string | Sim | O cabeçalho da secção exibido acima dos valores |
| values | array | Sim | Array de objetos de Valor contendo os seus dados |
{
"name": "Login Details",
"values": [
{
"value": "user@example.com",
"type": "note",
"id": "value_1763938238781_3jh5i3r20"
},
{
"value": "supersecretpassword123",
"type": "secret",
"id": "value_1763938251026_fvjeq1vg9"
}
]
}Valores
Os valores são as entradas de dados reais - os segredos, notas e códigos TOTP que armazena. Cada valor tem um tipo que determina como é exibido e como interage com ele na interface.
{
"value": "string", // Required: The actual content
"type": "secret" | "note" | "totp" | "link" | "email" | "username", // Required
"id": "string" // Optional: Unique identifier for sorting
}| Propriedade | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| value | string | Sim | O conteúdo real (palavra-passe, texto da nota, segredo TOTP) |
| type | string | Sim | Um de: "secret", "note", "totp", "link", "email" ou "username" |
| id | string | Não | Identificador único usado para ordenação e referência |
Tipos de Valor
| Tipo | Exibição | Caso de uso |
|---|---|---|
| "secret" | Oculto por padrão (•••••), clique para revelar | Palavras-passe, chaves de API, dados sensíveis |
| "note" | Texto simples sempre visível | Nomes de utilizador, e-mails, URLs, informações não sensíveis |
| "totp" | Gera códigos de 6 dígitos em tempo real | Segredos 2FA (codificados em Base32) |
| "link" | Hiperligação clicável | URLs, endereços de websites |
| "email" | Endereço de e-mail com link mailto | Endereços de e-mail |
| "username" | Texto simples sempre visível com ícone de utilizador | Nomes de utilizador, identificadores de conta |
// 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"
}Exemplo Completo
Aqui está uma estrutura de dados completa e válida que mostra toda a hierarquia com múltiplos cartões, registos, secções e diferentes tipos de valor.
{
"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
}
]
}Modo Bruto (Raw)
Se os seus dados desencriptados não seguirem a estrutura esperada, o Hexbon irá exibi-los na mesma, mas em modo bruto. Isto significa que verá os seus dados como JSON simples, sem as funcionalidades interativas fornecidas pelos dados estruturados.
| Funcionalidade | Modo Estruturado | Modo Bruto |
|---|---|---|
| Blocos de cartões interativos | ||
| Reordenação por arrastar e largar | ||
| Mascaramento de segredos com alternância de revelação | ||
| Geração de códigos TOTP em tempo real | ||
| Edição no local e gravação automática | ||
| Botões de cópia para a área de transferência |
Os seus dados estão sempre seguros
O modo bruto afeta apenas a exibição, não a segurança. Os seus dados são sempre encriptados com cifra AES-256-GCM, independentemente da estrutura. Simplesmente não terá as funcionalidades interativas da interface se a estrutura não corresponder.
Valide a sua Estrutura de Dados
Use a nossa ferramenta de validação interativa para verificar a sua estrutura de dados em tempo real.
Experimentar Ferramenta de Validação