Insomnia 8: Recuperação de Dados Perdidos e Opções de Migração

fTL;DR

Se você atualizou para o Insomnia 8.0 e perdeu o acesso às suas coleções, é provável que seus dados ainda estejam no disco. Este guia mostra como encontrá-los, recuperá-los do banco de dados SQLite e migrar de forma limpa para o Apidog ou outra alternativa. Aja antes de instalar quaisquer atualizações adicionais que possam sobrescrever seus arquivos de backup.

💡

Apidog é uma plataforma de desenvolvimento de API gratuita e completa. Ele importa coleções do Insomnia diretamente e armazena seus dados localmente sem a necessidade de uma conta. Experimente o Apidog gratuitamente, sem necessidade de cartão de crédito.

Botão

Introdução

A atualização do Insomnia 8.0 foi lançada em setembro de 2023 com login obrigatório na nuvem. Para muitos usuários, a atualização produziu um resultado desorientador: o aplicativo abriu em uma tela de login, e as coleções que eles haviam construído ao longo de meses ou anos pareciam ter desaparecido.

Alguma perda de dados foi real – particularmente em casos onde o armazenamento temporário corrompeu dados em certos sistemas. Mas, em muitos casos, os arquivos de banco de dados SQLite subjacentes ainda estavam intactos no disco, apenas inacessíveis através da nova interface de usuário sem uma conta Kong.

Este guia é para ambas as situações. Se seus dados ainda estiverem lá, você descobrirá como retirá-los. Se o armazenamento temporário realmente perdeu seus dados, você descobrirá quais opções de recuperação existem e como evitar o mesmo problema no futuro migrando para uma ferramenta com um modelo local-primeiro mais confiável.

Passo 1: Encontre seus arquivos de banco de dados Insomnia existentes

Antes de fazer qualquer outra coisa – antes de reinstalar, antes de criar uma conta Kong, antes de abrir o Insomnia novamente – localize seus arquivos de banco de dados existentes e copie-os para um local seguro.

O Insomnia armazenava dados em diferentes locais dependendo da versão e do sistema operacional.

macOS:

~/Library/Application Support/Insomnia/

Windows:

C:\Users\[NomeDeUsuário]\AppData\Roaming\Insomnia\

Linux:

~/.config/Insomnia/

Dentro desse diretório, procure por estes arquivos:

insomnia.db – o banco de dados principal (versões mais antigas)
Um diretório chamado core/ contendo arquivos .db – comum em versões anteriores à 8.0
workspaces/ – pode conter arquivos JSON exportados de exportações anteriores

Copie o diretório de suporte completo do aplicativo Insomnia para um local de backup agora mesmo. Não pule esta etapa. Se você executar outras atualizações ou desinstalar/reinstalar o Insomnia, há o risco de que esses arquivos sejam sobrescritos ou excluídos.

Passo 2: Tente a recuperação via a interface do usuário do Insomnia

Se você ainda não fez login em uma conta Kong, tente primeiro o caminho do armazenamento temporário. Quando o Insomnia exibir a tela de login, procure por um link ou botão que diga algo como “Usar sem conta” ou “Continuar com armazenamento local”. A redação exata mudou entre as versões.

Se você conseguir entrar no aplicativo sem fazer login, exporte imediatamente todos os workspaces:

Clique no nome de um workspace na barra lateral esquerda
Vá para o menu do workspace (três pontos ou ícone de engrenagem)
Escolha “Exportar”
Selecione o formato “Insomnia v4 (JSON)”
Salve o arquivo em um local seguro
Repita para cada workspace

Se você já possui uma conta Kong e pode fazer login, execute o mesmo processo de exportação. A experiência de login lhe dá acesso aos seus workspaces sincronizados, que podem ser mais completos do que o que está no disco se você já estava sincronizando anteriormente.

Passo 3: Recupere dados diretamente do banco de dados SQLite

Se a interface do usuário não lhe der acesso aos seus dados, você pode extraí-los diretamente do arquivo do banco de dados. Isso requer uma ferramenta gratuita de navegador SQLite.

Instale o DB Browser for SQLite. Faça o download em sqlitebrowser.org. É gratuito, de código aberto e está disponível para macOS, Windows e Linux.

Abra seu arquivo de banco de dados. No DB Browser, vá em Arquivo > Abrir Banco de Dados e navegue até o diretório de suporte do aplicativo Insomnia. Abra insomnia.db ou qualquer arquivo .db que você encontrar lá.

Explore o esquema. O banco de dados do Insomnia possui várias tabelas que lhe interessam:

Workspace – seus workspaces de nível superior
RequestGroup – pastas dentro de workspaces
Request – solicitações individuais
Environment – conjuntos de variáveis de ambiente
Response – histórico de respostas armazenadas (opcional para recuperar)

Exporte os dados. Na aba "Browse Data" (Navegar Dados), selecione cada tabela e use Arquivo > Exportar > Tabela como CSV para salvar os dados brutos. Para solicitações, os campos chave são name, url, method, headers (armazenados como JSON) e body.

Reconstrua as coleções. A abordagem CSV lhe dá os dados brutos para reconstruir. É tedioso, mas confiável. Para uma abordagem programática, você pode usar o módulo sqlite3 do Python para consultar o banco de dados e escrever um script de exportação.

Aqui está um script Python mínimo para extrair solicitações de um banco de dados Insomnia mais antigo:

import sqlite3
import json

conn = sqlite3.connect('/caminho/para/insomnia.db') # Tradução de comentário: /path/to/insomnia.db
cursor = conn.cursor()

cursor.execute("SELECT name, url, method, headers, body FROM Request")
rows = cursor.fetchall()

for row in rows:
    print(f"Nome: {row[0]}") # Tradução de comentário: Name
    print(f"Método: {row[2]} {row[1]}") # Tradução de comentário: Method
    if row[3]:
        headers = json.loads(row[3])
        for h in headers:
            print(f"  Cabeçalho: {h.get('name')}: {h.get('value')}") # Tradução de comentário: Header
    print()

conn.close()

Ajuste os nomes dos campos com base no que você vê no DB Browser – o esquema exato variava entre as versões do Insomnia.

Passo 4: Recupere de backups se o banco de dados estiver corrompido

Se o próprio arquivo do banco de dados estiver corrompido, as opções são mais limitadas.

Verifique o Time Machine ou backups do sistema. O Time Machine do macOS, o Histórico de Arquivos do Windows e a maioria dos serviços de backup em nuvem (Backblaze, iCloud Drive, etc.) podem ter snapshots do seu diretório Insomnia de antes da atualização. Restaure a versão pré-8.0 do diretório de suporte do aplicativo para um local separado e, em seguida, use o DB Browser para ler esses arquivos.

Verifique o histórico do git. Algumas equipes versionam suas exportações do Insomnia em um repositório git. Se sua organização faz isso, os arquivos de exportação são recuperáveis do histórico do git.

Procure por arquivos de exportação do Insomnia. Se você já exportou coleções manualmente no passado, esses arquivos JSON podem estar em sua pasta de Downloads ou em um diretório de projeto. Pesquise em seu sistema de arquivos por arquivos terminados em .json que contenham "insomnia" ou "_collection" no nome.

Passo 5: Migrar para o Apidog

Depois de ter seus dados no formato JSON do Insomnia v4 (seja por uma exportação da UI ou reconstruídos manualmente), migrar para o Apidog leva alguns minutos.

Importe suas coleções.

Abra o Apidog e crie um novo projeto
Vá para as configurações do projeto ou para a opção de importação na barra lateral
Escolha “Importar” e selecione “Insomnia”
Carregue seu arquivo JSON exportado
O Apidog irá analisar os workspaces, pastas, solicitações e ambientes

O que é transferido de forma limpa:

Requisições HTTP (GET, POST, PUT, DELETE, PATCH)
Cabeçalhos de requisição
Corpos de requisição (JSON, dados de formulário, multipart)
Parâmetros de URL e variáveis de caminho
Variáveis de ambiente e seus valores
Estrutura de pastas

O que precisa de revisão manual:

Scripts de pré-requisição e pós-requisição (JavaScript). O Apidog usa um modelo de script semelhante, mas a sintaxe pode precisar de ajustes.
Fluxos de autenticação personalizados que dependiam de plugins do Insomnia
Asserções de teste de resposta – estas precisam ser reinseridas no formato de teste do Apidog

Configure seus ambientes. Após a importação, verifique se as variáveis de ambiente foram importadas corretamente. Vá para o painel Ambientes e verifique se as URLs base, chaves de API e quaisquer tokens foram transferidos.

Verifique o acesso da equipe. Se você estiver migrando um workspace de equipe, o Apidog suporta workspaces compartilhados com sincronização opcional na nuvem. Você controla se os dados sincronizam com a nuvem do Apidog. Para equipes, habilitar a sincronização uma vez é a maneira mais fácil de compartilhar as coleções migradas.

Teste algumas requisições. Escolha cinco ou seis requisições representativas de sua coleção e execute-as para confirmar que funcionam como esperado. Preste atenção aos cabeçalhos de autenticação e à substituição de variáveis de ambiente.

Evitando este problema no futuro

A principal lição da situação do Insomnia 8.0 é que confiar seus dados de trabalho críticos a uma única ferramenta sem uma estratégia de backup é arriscado – independentemente da ferramenta que você usa.

Alguns hábitos que o protegerão no futuro:

Exporte regularmente. Agende uma exportação mensal de suas coleções para uma pasta de backup ou um repositório git. Isso leva dois minutos e lhe dá um caminho de recuperação, não importa o que aconteça.

Escolha ferramentas com foco local. O Apidog armazena dados localmente por padrão. O Bruno armazena coleções como arquivos simples no disco. Ambos permitem que você veja e faça backup de seus dados sem depender da nuvem de um fornecedor.

Verifique o modelo de dados antes de atualizar. Quando uma versão principal é lançada, leia as notas de migração antes de atualizar. Se a versão mudar onde ou como os dados são armazenados, entenda as implicações antes de clicar em instalar.

FAQ

Posso recuperar dados do Insomnia sem fazer login no Kong?Sim, se seus arquivos de banco de dados ainda estiverem no disco. Use o DB Browser for SQLite para abrir o arquivo .db em seu diretório de suporte do aplicativo Insomnia e exportar os dados diretamente das tabelas.

Qual formato devo usar ao exportar dados do Insomnia?Use o formato JSON do Insomnia v4. Este é o formato mais amplamente suportado e pode ser importado pelo Apidog, Postman e outras ferramentas.

Minhas variáveis de ambiente serão transferidas para o Apidog?Na maioria dos casos, sim. Os ambientes do Insomnia exportam como parte do formato JSON v4 e o Apidog os importa. Revise os ambientes importados para confirmar que os valores estão corretos, especialmente para tokens sensíveis.

Qual a diferença entre o armazenamento temporário do Insomnia e o armazenamento local em outras ferramentas?O armazenamento temporário do Insomnia era um modo de fallback com problemas de confiabilidade. O Apidog e o Bruno tratam o armazenamento local como o modelo primário, não um fallback. Os dados são gravados no disco a cada salvamento, e não mantidos na memória.

Posso usar o DB Browser for SQLite no macOS?Sim. O DB Browser for SQLite está disponível para macOS através do site do projeto e via Homebrew (brew install db-browser-for-sqlite).

Quanto tempo leva a migração do Insomnia para o Apidog?Para uma coleção típica de 50 a 200 requisições, a importação leva menos de cinco minutos. A revisão e o ajuste de scripts e fluxos de autenticação podem levar mais tempo, dependendo da complexidade.