Insomnio Pérdida de Datos 8: Pasos de Recuperación y Opciones de Migración

fTL;DR (Demasiado Largo; No Lo Leí)

Si actualizaste a Insomnia 8.0 y perdiste el acceso a tus colecciones, es probable que tus datos aún estén en el disco. Esta guía te muestra cómo encontrarlos, recuperarlos de la base de datos SQLite y migrar de forma limpia a Apidog u otra alternativa. Actúa antes de instalar cualquier otra actualización que pueda sobrescribir tus archivos de respaldo.

💡

Apidog es una plataforma gratuita todo en uno para el desarrollo de API. Importa colecciones de Insomnia directamente y almacena tus datos localmente sin requerir una cuenta. Prueba Apidog gratis, no se requiere tarjeta de crédito.

button

Introducción

La actualización Insomnia 8.0, lanzada en septiembre de 2023, incluía un inicio de sesión obligatorio en la nube. Para muchos usuarios, la actualización produjo un resultado desorientador: la aplicación se abría a una pantalla de inicio de sesión, y las colecciones que habían construido durante meses o años parecían haber desaparecido.

Parte de la pérdida de datos fue real, particularmente en casos donde el almacenamiento temporal (scratch storage) corrompió datos en ciertos sistemas. Pero en muchos casos, los archivos subyacentes de la base de datos SQLite todavía estaban intactos en el disco, simplemente inaccesibles a través de la nueva interfaz de usuario sin una cuenta de Kong.

Esta guía es para ambas situaciones. Si tus datos todavía están allí, descubrirás cómo extraerlos. Si el almacenamiento temporal realmente perdió tus datos, descubrirás qué opciones de recuperación existen y cómo evitar el mismo problema en el futuro migrando a una herramienta con un modelo local-first más confiable.

Paso 1: Encuentra tus archivos de base de datos de Insomnia existentes

Antes de hacer cualquier otra cosa, antes de reinstalar, antes de crear una cuenta de Kong, antes de abrir Insomnia nuevamente, localiza tus archivos de base de datos existentes y cópialos a un lugar seguro.

Insomnia almacenaba datos en diferentes ubicaciones dependiendo de la versión y el sistema operativo.

macOS:

~/Library/Application Support/Insomnia/

Windows:

C:\Users\[Username]\AppData\Roaming\Insomnia\

Linux:

~/.config/Insomnia/

Dentro de ese directorio, busca estos archivos:

insomnia.db – la base de datos principal (versiones antiguas)
Un directorio llamado core/ que contiene archivos .db – común en versiones anteriores a la 8.0
workspaces/ – puede contener archivos JSON exportados de exportaciones anteriores

Copia todo el directorio de soporte de la aplicación Insomnia a una ubicación de respaldo ahora mismo. No omitas este paso. Si ejecutas más actualizaciones o desinstalas/reinstalas Insomnia, existe el riesgo de que estos archivos se sobrescriban o eliminen.

Paso 2: Intenta la recuperación a través de la interfaz de usuario de Insomnia

Si aún no has iniciado sesión en una cuenta de Kong, intenta primero la ruta del almacenamiento temporal (scratch storage). Cuando Insomnia muestre la pantalla de inicio de sesión, busca un enlace o botón que diga algo como "Usar sin cuenta" o "Continuar con almacenamiento local". La redacción exacta ha cambiado entre versiones.

Si puedes acceder a la aplicación sin iniciar sesión, exporta inmediatamente cada espacio de trabajo:

Haz clic en el nombre de un espacio de trabajo en la barra lateral izquierda
Ve al menú del espacio de trabajo (tres puntos o icono de engranaje)
Elige "Exportar"
Selecciona el formato "Insomnia v4 (JSON)"
Guarda el archivo en un lugar seguro
Repite para cada espacio de trabajo

Si ya tienes una cuenta de Kong y puedes iniciar sesión, realiza el mismo proceso de exportación. La experiencia de inicio de sesión te da acceso a tus espacios de trabajo sincronizados, que pueden ser más completos que lo que está en el disco si habías estado sincronizando previamente.

Paso 3: Recuperar datos directamente de la base de datos SQLite

Si la interfaz de usuario no te da acceso a tus datos, puedes extraerlos directamente del archivo de la base de datos. Esto requiere una herramienta de navegador SQLite gratuita.

Instala DB Browser para SQLite. Descárgalo desde sqlitebrowser.org. Es gratuito, de código abierto y está disponible para macOS, Windows y Linux.

Abre tu archivo de base de datos. En DB Browser, ve a Archivo > Abrir Base de Datos y navega al directorio de soporte de la aplicación Insomnia. Abre insomnia.db o cualquier archivo .db que encuentres allí.

Explora el esquema. La base de datos de Insomnia tiene varias tablas que te interesan:

Workspace – tus espacios de trabajo de nivel superior
RequestGroup – carpetas dentro de los espacios de trabajo
Request – solicitudes individuales
Environment – conjuntos de variables de entorno
Response – historial de respuestas almacenadas (opcional de recuperar)

Exporta los datos. En la pestaña "Examinar Datos" (Browse Data), selecciona cada tabla y usa Archivo > Exportar > Tabla como CSV para guardar los datos sin procesar. Para las solicitudes, los campos clave son name, url, method, headers (almacenados como JSON) y body.

Reconstruye las colecciones. El enfoque CSV te proporciona los datos en bruto para reconstruir. Es tedioso pero confiable. Para un enfoque programático, puedes usar el módulo sqlite3 de Python para consultar la base de datos y escribir un script de exportación.

Aquí tienes un script mínimo de Python para extraer solicitudes de una base de datos de Insomnia antigua:

import sqlite3
import json

conn = sqlite3.connect('/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"Name: {row[0]}")
    print(f"Method: {row[2]} {row[1]}")
    if row[3]:
        headers = json.loads(row[3])
        for h in headers:
            print(f"  Header: {h.get('name')}: {h.get('value')}")
    print()

conn.close()

Ajusta los nombres de los campos según lo que veas en DB Browser; el esquema exacto varió entre las versiones de Insomnia.

Paso 4: Recuperar de respaldos si la base de datos está corrupta

Si el archivo de la base de datos está corrupto, las opciones son más limitadas.

Verifica Time Machine o respaldos del sistema. Time Machine de macOS, Historial de Archivos de Windows y la mayoría de los servicios de respaldo en la nube (Backblaze, iCloud Drive, etc.) pueden tener instantáneas de tu directorio de Insomnia de antes de la actualización. Restaura la versión pre-8.0 del directorio de soporte de la aplicación a una ubicación separada, luego usa DB Browser para leer esos archivos.

Verifica el historial de git. Algunos equipos versionan sus exportaciones de Insomnia en un repositorio git. Si tu organización hace esto, los archivos de exportación son recuperables del historial de git.

Busca archivos de exportación de Insomnia. Si alguna vez exportaste colecciones manualmente en el pasado, esos archivos JSON pueden estar en tu carpeta de Descargas o en un directorio de proyecto. Busca en tu sistema de archivos archivos que terminen en .json y que contengan "insomnia" o "_collection" en el nombre.

Paso 5: Migrar a Apidog

Una vez que tengas tus datos en formato JSON de Insomnia v4 (ya sea desde una exportación de la interfaz de usuario o reconstruidos manualmente), la migración a Apidog toma unos minutos.

Importa tus colecciones.

Abre Apidog y crea un nuevo proyecto
Ve a la configuración del proyecto o a la opción de importación en la barra lateral
Elige "Importar" y selecciona "Insomnia"
Sube tu archivo JSON exportado
Apidog analizará los espacios de trabajo, carpetas, solicitudes y entornos

Qué se transfiere limpiamente:

Solicitudes HTTP (GET, POST, PUT, DELETE, PATCH)
Encabezados de solicitud
Cuerpos de solicitud (JSON, datos de formulario, multipart)
Parámetros de URL y variables de ruta
Variables de entorno y sus valores
Estructura de carpetas

Qué necesita revisión manual:

Scripts previos y posteriores a la solicitud (JavaScript). Apidog utiliza un modelo de scripting similar, pero la sintaxis puede necesitar ajustes.
Flujos de autenticación personalizados que dependían de plugins de Insomnia
Aserciones de pruebas de respuesta: estas deben volver a ingresarse en el formato de prueba de Apidog.

Configura tus entornos. Después de la importación, verifica que las variables de entorno se hayan importado correctamente. Ve al panel de Entornos y verifica las URL base, las claves de API y los tokens transferidos.

Verifica el acceso del equipo. Si estás migrando un espacio de trabajo en equipo, Apidog admite espacios de trabajo compartidos con sincronización en la nube opcional. Tú controlas si los datos se sincronizan con la nube de Apidog. Para los equipos, habilitar la sincronización una vez es la forma más fácil de compartir las colecciones migradas.

Prueba algunas solicitudes. Elige cinco o seis solicitudes representativas de tu colección y ejecútalas para confirmar que funcionan como se espera. Presta atención a los encabezados de autenticación y la sustitución de variables de entorno.

Evitando este problema en el futuro

La lección principal de la situación de Insomnia 8.0 es que confiar tus datos de trabajo críticos a una sola herramienta sin una estrategia de respaldo es arriesgado, independientemente de la herramienta que uses.

Algunos hábitos que te protegerán en el futuro:

Exporta regularmente. Programa una exportación mensual de tus colecciones a una carpeta de respaldo o a un repositorio git. Esto toma dos minutos y te proporciona una ruta de recuperación sin importar lo que suceda.

Elige herramientas con prioridad local. Apidog almacena los datos localmente por defecto. Bruno almacena las colecciones como archivos planos en el disco. Ambas te permiten ver y respaldar tus datos sin depender de la nube de un proveedor.

Verifica el modelo de datos antes de actualizar. Cuando se lanza una versión principal, lee las notas de migración antes de actualizar. Si la versión cambia dónde o cómo se almacenan los datos, comprende las implicaciones antes de hacer clic en instalar.

Preguntas Frecuentes

¿Puedo recuperar datos de Insomnia sin iniciar sesión en Kong?Sí, si tus archivos de base de datos todavía están en el disco. Usa DB Browser para SQLite para abrir el archivo .db en tu directorio de soporte de la aplicación Insomnia y exportar los datos de las tablas directamente.

¿Qué formato debo usar al exportar datos de Insomnia?Usa el formato JSON de Insomnia v4. Este es el formato más ampliamente compatible y puede ser importado por Apidog, Postman y otras herramientas.

¿Mis variables de entorno se transferirán a Apidog?En la mayoría de los casos, sí. Los entornos de Insomnia se exportan como parte del formato JSON v4 y Apidog los importa. Revisa los entornos importados para confirmar que los valores son correctos, especialmente para tokens sensibles.

¿Cuál es la diferencia entre el almacenamiento temporal (scratch storage) de Insomnia y el almacenamiento local en otras herramientas?El almacenamiento temporal (scratch storage) de Insomnia era un modo de reserva con problemas de confiabilidad. Apidog y Bruno tratan el almacenamiento local como el modelo principal, no como una alternativa. Los datos se escriben en el disco en cada guardado, no se mantienen en memoria.

¿Puedo usar DB Browser para SQLite en macOS?Sí. DB Browser para SQLite está disponible para macOS a través del sitio web del proyecto y a través de Homebrew (brew install db-browser-for-sqlite).

¿Cuánto tiempo lleva la migración de Insomnia a Apidog?Para una colección típica de 50-200 solicitudes, la importación toma menos de cinco minutos. Revisar y ajustar scripts y flujos de autenticación puede llevar más tiempo, dependiendo de la complejidad.