Como Exportar Campos do Perfil do Mastodon com Token da API

Você quer exportar os campos do seu perfil do Mastodon — os rótulos e valores personalizados que você definiu nas configurações — para fazer backup ou reutilizá-los em outra instância. O Mastodon não oferece uma exportação com um clique para campos de perfil na interface web. No entanto, você pode recuperá-los programaticamente usando seu token de API e uma chamada simples. Este artigo explica como gerar o token, chamar o endpoint correto e salvar os campos como um arquivo JSON estruturado.

Entendendo a API do Mastodon e os Campos do Perfil

Os campos do perfil são pares chave-valor personalizados que você adiciona ao seu perfil do Mastodon — por exemplo, “Site” com uma URL ou “Pronomes” com texto. Cada campo tem um nome, um valor e um timestamp verified_at se o valor foi verificado. A API do Mastodon expõe esses campos no array fields do objeto Account quando você chama o endpoint verify_credentials.

Para acessar esses dados, você precisa de um token de acesso com o escopo read:accounts. Esse token está vinculado à sua conta do Mastodon e permite que a API retorne seus próprios dados de perfil. Você gera o token pela interface web do Mastodon criando uma nova aplicação nas configurações de desenvolvedor. O token é uma longa string alfanumérica que você passa no cabeçalho Authorization da sua requisição à API.

A resposta da API está no formato JSON. Ela inclui não apenas os campos do perfil, mas também seu nome de exibição, biografia, URL do avatar, imagem de cabeçalho, número de seguidores e outros metadados. Para a exportação, você só precisa do array fields, mas salvar o objeto inteiro do perfil fornece um backup completo.

Passos para Exportar Campos do Perfil Usando o Token da API

1. Faça login na sua instância do Mastodon
   Abra sua instância do Mastodon em um navegador web. Faça login com suas credenciais. Certifique-se de estar na instância onde deseja exportar os campos — por exemplo, mastodon.social ou seu próprio domínio.
2. Navegue até Preferências > Desenvolvimento
   Clique no ícone de engrenagem na barra de menu superior direita para abrir Preferências. Na barra lateral esquerda, clique em Desenvolvimento. Esta página lista os aplicativos existentes e permite criar novos.
3. Crie uma nova aplicação
   Clique no botão Nova Aplicação. Um formulário aparece. Digite um nome para a aplicação — por exemplo, “Ferramenta de Exportação de Perfil”. O nome é apenas para sua referência e não afeta a funcionalidade.
4. Defina o escopo da API necessário
   Na seção Escopos, você precisa no mínimo do escopo read:accounts. Desmarque todos os outros escopos, a menos que planeje usar o token para outros fins. Clique em Enviar para criar a aplicação.
5. Copie o token de acesso
   Após o envio, a página mostra os detalhes da aplicação. Localize o campo Seu token de acesso. Clique no ícone de copiar ou selecione a string do token e copie para a área de transferência. Armazene este token com segurança — trate-o como uma senha.
6. Abra um terminal ou prompt de comando
   No Windows, abra o Prompt de Comando ou PowerShell. No macOS ou Linux, abra o Terminal. Certifique-se de que o curl está instalado. A maioria dos sistemas inclui o curl por padrão. Se não, instale-o pelo gerenciador de pacotes ou em curl.se.
7. Chame o endpoint verify_credentials
   Execute o seguinte comando curl, substituindo SUA_INSTANCIA pelo domínio da sua instância (por exemplo, mastodon.social) e SEU_TOKEN pelo token que você copiou:

   curl -H "Authorization: Bearer SEU_TOKEN" https://SUA_INSTANCIA/api/v1/accounts/verify_credentials

   Pressione Enter. A API retorna um objeto JSON contendo seu perfil completo.

8. Salve a resposta em um arquivo
   Para salvar a saída em um arquivo, redirecione a resposta com o operador >. Por exemplo:

   curl -H "Authorization: Bearer SEU_TOKEN" https://SUA_INSTANCIA/api/v1/accounts/verify_credentials > profile.json

   Isso cria um arquivo chamado profile.json no diretório atual. Abra-o com qualquer editor de texto para visualizar os dados.

9. Extraia o array fields
   Abra profile.json em um editor de texto ou use jq para filtrar apenas os campos. Se você tiver o jq instalado, execute:

   jq '.fields' profile.json > fields.json

   Isso cria um novo arquivo fields.json contendo apenas o array de campos do perfil. Cada objeto de campo inclui name, value e verified_at.

Erros Comuns e Limitações ao Exportar Campos do Perfil

Escopo do token da API sem read:accounts

Se o seu token não incluir o escopo read:accounts, a API retorna um erro 403 Forbidden. Para corrigir, exclua a aplicação em Preferências > Desenvolvimento e crie uma nova com o escopo correto. Alternativamente, edite a aplicação existente — o Mastodon permite alterações de escopo em aplicações salvas.

Usar a URL da instância errada na chamada da API

O endpoint da API deve corresponder à instância onde você criou o token. Se você gerou o token em mastodon.social mas chamar mastodon.online, a requisição falha com 401 Unauthorized ou 404 Not Found. Sempre verifique o domínio da instância na barra de endereços do navegador.

Token exposto em scripts ou controle de versão

Nunca codifique seu token em scripts que você envia para um repositório público. Use variáveis de ambiente ou um arquivo de configuração excluído do controle de versão. Se seu token vazar, revogue-o imediatamente excluindo a aplicação em Preferências > Desenvolvimento.

Campos do perfil com HTML são exportados como HTML bruto

Os campos do perfil do Mastodon suportam um subconjunto de tags HTML como e . Quando exportados, essas tags aparecem como HTML bruto no campo value. Se você planeja importar os campos para outro serviço, pode ser necessário remover ou converter as tags HTML manualmente.