Como Ler o JSON de Exportação de Configurações da Conta do Mastodon

Ao exportar as configurações da sua conta no Mastodon, a plataforma gera um arquivo JSON contendo seu perfil, preferências e outros dados de configuração. Muitos usuários exportam esse arquivo para backup ou migração, mas têm dificuldade em interpretar a estrutura JSON bruta. Este artigo explica as principais seções do arquivo JSON de exportação do Mastodon e mostra como ler cada campo. Você aprenderá quais configurações são armazenadas, como os valores são formatados e onde residem dados críticos como sua biografia e URL do avatar.

Entendendo a Estrutura JSON das Configurações da Conta do Mastodon

O JSON de configurações da conta do Mastodon é um arquivo estruturado que usa pares chave-valor para armazenar a configuração da sua conta. O arquivo é gerado quando você navega até Configurações > Exportar > Exportar configurações da conta e clica no botão de exportação. O Mastodon produz um único arquivo JSON com um nome como mastodon_account_settings_20250215.json.

O arquivo contém vários objetos de nível superior. Cada objeto representa uma categoria de configurações. As chaves de nível superior mais importantes são:

• profile — armazena seu nome de exibição, biografia, avatar, imagem de cabeçalho e campos de metadados.
• preferences — armazena suas preferências de interface do usuário, como privacidade padrão de postagens, idioma e tema.
• identity_proofs — armazena provas de identidade externas, como contas vinculadas do Twitter ou GitHub.

O JSON usa tipos de dados padrão: strings para texto, números para valores numéricos, booleanos para flags verdadeiro/falso, arrays para listas e objetos para grupos aninhados. Datas são armazenadas como strings ISO 8601, por exemplo "2025-02-15T10:30:00Z".

Antes de ler o arquivo, você precisa de um editor de texto ou um visualizador JSON. Qualquer editor de texto simples, como Bloco de Notas no Windows ou TextEdit no macOS, pode abrir o arquivo. Para facilitar a navegação, use uma ferramenta que suporte realce de sintaxe JSON, como Visual Studio Code, Notepad++ ou um visualizador JSON online.

Chaves de Nível Superior no Arquivo de Exportação

Abra o arquivo JSON exportado no seu editor. O arquivo começa com uma chave { e termina com }. As chaves de nível superior estão no primeiro nível de indentação. As chaves típicas incluem:

• "profile"
• "preferences"
• "identity_proofs"

Algumas instâncias podem incluir chaves adicionais como "follows" ou "mutes" dependendo da versão do Mastodon. As configurações principais da conta estão sempre sob as três chaves listadas acima.

Lendo a Seção de Perfil

O objeto "profile" contém todos os dados que você vê no seu perfil público do Mastodon. Localize a chave "profile" no JSON. Abaixo dela está um objeto com os seguintes campos comuns:

• display_name — uma string. Exemplo: "João Silva". Este é o nome exibido no seu perfil e postagens.
• note — uma string. Exemplo: "Engenheiro de software e amante de café.". Este é o texto da sua biografia. A string pode incluir tags HTML como <p> ou <a>.
• avatar — uma string contendo uma URL. Exemplo: "https://mastodon.exemplo.com/avatars/12345.png". Este é o link para sua foto de perfil armazenada no servidor.
• avatar_static — uma string contendo uma URL. Esta é uma versão estática do avatar, usada quando animações estão desativadas.
• header — uma string contendo uma URL. Este é o link para sua imagem de cabeçalho.
• header_static — uma string contendo uma URL. Versão estática da imagem de cabeçalho.
• locked — um booleano. true significa que você tem uma conta bloqueada onde novos seguidores precisam ser aprovados. false significa conta aberta.
• bot — um booleano. true marca a conta como um bot.
• fields_attributes — um array de objetos. Cada objeto representa um campo de metadados no seu perfil. Cada objeto tem as chaves "name" e "value". Exemplo: [{"name": "Website", "value": "https://joaosilva.com"}].

Para ler um campo específico, localize a chave dentro do objeto profile. Por exemplo, para ver sua biografia, procure por "note" e leia o valor string após os dois pontos. Se o valor for null, o campo está vazio.

Lendo a Seção de Preferências

O objeto "preferences" armazena suas configurações de interface do usuário. Encontre a chave "preferences" no JSON. Campos comuns incluem:

• posting_default_visibility — uma string. Valores possíveis: "public", "unlisted", "private", "direct". Este é o nível de privacidade padrão para novas postagens.
• posting_default_sensitive — um booleano. true marca toda nova mídia como sensível por padrão.
• posting_default_language — uma string. Exemplo: "pt". Este é o idioma padrão para suas postagens.
• reading_expand_media — uma string. Valores possíveis: "default", "show_all", "hide_all". Controla como os anexos de mídia são exibidos na sua linha do tempo.
• reading_autoplay_gifs — um booleano. true permite que GIFs animados sejam reproduzidos automaticamente.
• theme — uma string. Exemplo: "mastodon-light" ou "contrast". Este é o tema selecionado.

Cada chave de preferência corresponde a uma configuração que você pode alterar na interface web do Mastodon em Configurações > Preferências. Os valores são armazenados exatamente como você os definiu. Se você vir um valor que não reconhece, verifique a página de preferências do Mastodon para a opção correspondente.

Lendo a Seção de Provas de Identidade

O objeto "identity_proofs" contém verificações de identidade externas. Esta seção geralmente é menor que as outras. Cada prova é um objeto com chaves como:

• provider — uma string. Exemplo: "twitter" ou "github".
• provider_username — uma string. Exemplo: "joaosilva".
• updated_at — uma string de data ISO 8601. Exemplo: "2025-02-10T14:22:00Z".

Se você não tiver provas de identidade configuradas, o valor de "identity_proofs" será um objeto vazio {}.

Como Interpretar Objetos e Arrays Aninhados

JSON usa chaves {} para objetos e colchetes [] para arrays. Na seção de perfil, "fields_attributes" é um array. Cada elemento do array é um objeto com "name" e "value". O array pode ter zero ou mais elementos. Para ler todos os campos de metadados, procure pelo colchete de abertura [ após "fields_attributes". Cada objeto dentro é separado por vírgula.

Por exemplo, se o JSON mostrar:

"fields_attributes": [
  {
    "name": "Website",
    "value": "https://joaosilva.com"
  },
  {
    "name": "Localização",
    "value": "Porto Alegre, RS"
  }
]

Isso significa que seu perfil tem dois campos de metadados: um chamado “Website” com o valor “https://joaosilva.com”, e outro chamado “Localização” com o valor “Porto Alegre, RS”.

Problemas Comuns ao Ler o JSON de Exportação

Arquivo Contém Apenas uma Única Linha de Texto

Por padrão, o arquivo de exportação é minificado — todo o JSON está em uma linha. Para lê-lo, use um formatador JSON ou um editor de texto com função de pretty-print. No Visual Studio Code, pressione Shift + Alt + F para formatar o documento. Ferramentas online como JSONLint também funcionam.

Chaves Esperadas Ausentes

Se você espera uma chave como "follows" mas não a vê, a exportação pode incluir apenas as configurações da conta, não os dados do grafo social. Para exportar listas de seguidores e seguindo, use as opções de exportação separadas em Configurações > Exportar > Exportar lista de seguidores e Exportar lista de seguindo.

Valores Aparecem como Null

Um valor null significa que o campo não foi definido. Por exemplo, se você nunca adicionou uma imagem de cabeçalho, a chave "header" mostrará null. Isso é normal e não indica um erro.

Exportação JSON do Mastodon vs Exportação CSV: Principais Diferenças

Item	Exportação JSON	Exportação CSV
Formato do arquivo	JSON estruturado com objetos e arrays aninhados	Tabela plana com valores separados por vírgula
Dados incluídos	Configurações de perfil, preferências, provas de identidade	Lista de seguidores, lista de seguindo, bloqueios, silêncios
Legibilidade	Requer um visualizador JSON ou formatador para leitura fácil	Pode ser aberto diretamente em software de planilha
Capacidade de reimportação	Pode ser reimportado no Mastodon via Configurações > Importar	Pode ser reimportado apenas para listas específicas (seguindo, bloqueios)

A exportação JSON é o arquivo correto para fazer backup da configuração completa da sua conta. As exportações CSV são melhores para transferir listas de seguidores entre instâncias.

Agora você pode abrir qualquer arquivo JSON de configurações da conta do Mastodon e identificar as seções de perfil, preferências e provas de identidade. Para verificar sua interpretação, compare os valores no JSON com as configurações mostradas na interface web do Mastodon. Para usuários avançados, o arquivo JSON pode ser editado e reimportado para aplicar alterações em massa, mas certifique-se de que o JSON permaneça válido antes de importar.