Insomnie et Perte de Données: Récupération et Migration

fTL;DR

Si vous avez mis à niveau vers Insomnia 8.0 et perdu l'accès à vos collections, vos données sont probablement toujours sur le disque. Ce guide explique comment les localiser, les extraire de la base SQLite et migrer proprement vers Apidog ou une autre alternative. Sauvegardez vos fichiers avant toute mise à jour supplémentaire qui pourrait les écraser.

Essayez Apidog dès aujourd'hui

💡 Apidog est une plateforme de développement API tout-en-un gratuite. Elle importe directement les collections Insomnia et stocke vos données localement sans nécessiter de compte. Essayez Apidog gratuitement, aucune carte de crédit requise.

Introduction

La mise à jour Insomnia 8.0, déployée en septembre 2023, a imposé une connexion cloud obligatoire. Beaucoup d’utilisateurs ont vu apparaître un écran de connexion et leurs collections semblaient perdues.

Dans certains cas, des pertes de données sont survenues (notamment à cause du "scratch storage" corrompu). Mais le plus souvent, la base SQLite d’Insomnia restait intacte sur le disque, simplement inaccessible sans compte Kong.

Ce guide couvre les deux cas : récupération des données existantes et options si la base est corrompue, avec conseils pour migrer vers un outil local-first plus fiable.

Étape 1 : Localiser vos fichiers de base de données Insomnia

Avant toute opération (réinstallation, création de compte Kong, réouverture d’Insomnia), localisez vos fichiers de base de données et sauvegardez-les.

Selon l’OS, les dossiers sont :

macOS :

~/Library/Application Support/Insomnia/

Windows :

C:\Users\[Nom d'utilisateur]\AppData\Roaming\Insomnia\

Linux :

~/.config/Insomnia/

Dans ce répertoire, recherchez :

• insomnia.db – base principale (v. anciennes)
• Dossier core/ avec des fichiers .db – courant avant la v8.0
• Dossier workspaces/ – fichiers JSON d’export précédents

Copiez tout le dossier vers un emplacement sûr. Ne sautez pas cette étape : une mise à jour ou une réinstallation pourrait effacer ces fichiers.

Étape 2 : Récupération via l’interface d’Insomnia

Si vous n’avez pas encore créé de compte Kong, tentez d’utiliser le "scratch storage". Sur l’écran de connexion, cherchez un bouton « Utiliser sans compte » ou « Continuer avec le stockage local » (le texte varie selon la version).

Si vous accédez à l’application :

1. Cliquez sur le nom d’un espace de travail dans la barre latérale.
2. Ouvrez le menu (trois points ou engrenage).
3. Choisissez « Exporter ».
4. Sélectionnez le format « Insomnia v4 (JSON) ».
5. Enregistrez le fichier.
6. Répétez pour chaque workspace.

Si vous avez un compte Kong et pouvez vous connecter, effectuez le même export. Si vos workspaces étaient synchronisés, ils peuvent être plus à jour que la base locale.

Étape 3 : Extraction directe via SQLite

Si l’interface ne donne pas accès à vos données, il est possible de les extraire directement de la base SQLite.

1. Installez DB Browser for SQLite

Téléchargez-le sur sqlitebrowser.org. Gratuit, open-source, multiplateforme.

2. Ouvrez la base de données

Dans DB Browser, allez dans Fichier > Ouvrir la base de données et naviguez jusqu’au dossier Insomnia. Ouvrez insomnia.db ou tout autre fichier .db.

3. Explorez le schéma

Les tables principales :

• Workspace – espaces de travail
• RequestGroup – dossiers/folders
• Request – requêtes individuelles
• Environment – variables d’environnement
• Response – historique des réponses (optionnel)

4. Exportez les données

Dans l’onglet "Parcourir les données", exportez chaque table via Fichier > Exporter > Table en CSV.

Pour les requêtes, les champs clés sont : name, url, method, headers (JSON), body.

5. Extraction programmatique

Pour automatiser, utilisez Python et sqlite3 :

import sqlite3
import json

conn = sqlite3.connect('/chemin/vers/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()

Adaptez les champs selon le schéma exact de votre version.

Étape 4 : Récupération sur sauvegarde si la base est corrompue

Si la base SQLite est corrompue :

• Sauvegardes système : Utilisez Time Machine (macOS), Historique des fichiers (Windows) ou services cloud (Backblaze, iCloud, etc.) pour restaurer une version antérieure du dossier Insomnia. Relisez-la dans DB Browser.
• Historique Git : Si vos exports Insomnia sont versionnés dans un repo, récupérez-les depuis l’historique.
• Exports manuels : Cherchez dans vos dossiers des fichiers .json contenant « insomnia » ou « _collection ».

Étape 5 : Migrer vers Apidog

Quand vous disposez d’un export JSON Insomnia v4, la migration vers Apidog est rapide.

1. Importez vos collections

1. Ouvrez Apidog et créez un nouveau projet.
2. Accédez aux paramètres ou à l’option d’importation.
3. Choisissez « Importer » > « Insomnia ».
4. Importez votre fichier JSON.
5. Apidog analysera workspaces, dossiers, requêtes, et environnements.

2. Ce qui est transféré automatiquement

• Requêtes HTTP (GET, POST, PUT, DELETE, PATCH)
• En-têtes
• Corps (JSON, form-data, multipart)
• Paramètres d’URL, variables de chemin
• Variables d’environnement et leurs valeurs
• Structure des dossiers

3. Ce qui nécessite vérification manuelle

• Scripts pré-/post-requête (JS) : syntaxe à ajuster si besoin.
• Auth personnalisée basée sur des plugins Insomnia.
• Tests/assertions de réponse : à ressaisir dans Apidog.

4. Vérifiez vos environnements

Après import, validez les variables d’environnement (URL de base, clés API, tokens).

5. Accès équipe

Pour migrer un workspace d’équipe, Apidog prend en charge les workspaces partagés avec synchronisation cloud optionnelle. Activez la synchronisation si besoin pour partager les collections.

6. Testez vos requêtes

Exécutez quelques requêtes représentatives pour vérifier la migration (notamment authentification et variables d’environnement).

Comment éviter ce problème à l’avenir

• Exportez régulièrement : Planifiez un export mensuel dans un dossier ou un dépôt Git.
• Privilégiez le local-first : Apidog stocke localement par défaut. Bruno stocke aussi sur disque. Ainsi, vos données restent accessibles et sauvegardables.
• Vérifiez les notes de migration avant chaque mise à jour majeure, surtout si elle modifie le stockage des données.

FAQ

Puis-je récupérer mes données Insomnia sans compte Kong ?

Oui, si vos fichiers .db sont encore sur le disque. Utilisez DB Browser for SQLite pour les ouvrir et exporter les données.

Quel format d’export utiliser ?

JSON Insomnia v4 – le plus supporté, importable par Apidog, Postman, etc.

Mes variables d’environnement sont-elles transférées vers Apidog ?

Dans la majorité des cas, oui. Elles sont incluses dans l’export v4 et importées par Apidog. Vérifiez toujours les valeurs sensibles.

Différence entre scratch storage d’Insomnia et stockage local d’Apidog/Bruno ?

Le scratch storage d’Insomnia est un mode de secours peu fiable. Apidog et Bruno privilégient le stockage local par défaut : chaque sauvegarde écrit sur disque, pas seulement en mémoire.

Puis-je utiliser DB Browser for SQLite sur macOS ?

Oui. Téléchargez-le via le site officiel ou avec Homebrew (brew install db-browser-for-sqlite).

Combien de temps prend la migration vers Apidog ?

Pour 50–200 requêtes, moins de 5 minutes pour l’import. L’ajustement des scripts/tests dépend de leur complexité.